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Android 是 谷歌 (Google) 发 布 的 一 个 开放 源 代 码 的 手机 平台 ， 
由 Linux 内 核 、 中 间 件 、 应 用 程序 框架 和 应 用 软件 组 成 ,是 第 一 个 可 
以 完全 定制 ,免费 .开放 的 手机 平台 。Android 不 仅 能 够 在 智能 手机 
中 使 用 ,还 可 以 用 在 移动 互联 网 终端 (MID)、 上 网 笔记 本 、 便 携 式 媒 
体 播 放 器 (PMP) 和 汽车 电子 等 其 他 手持 设备 上 。 

Android 在 诞生 之 日 起 便 受 到 广泛 的 关注 。 到 目前 为 止 ,中 国 
台湾 的 宏达电 (HTC) 已 推出 了 三 款 Android 手机 ,LG、 三 星 、 摩 托 
罗拉 、 索 尼 爱 立信 、 宏 甘 、 华 硕 和 联想 也 相继 推出 自己 的 Android 手 
机 ,中 国 移动 、 中 国联 通 等 运营 商 也 在 研发 基于 该 系统 的 手机 操作 
平台 。 据 市 场 调查 机 构 预 期 ,2009 年 全 球 Android 手机 的 总 规模 达 
800 万 部 ,2013 年 全 球 应 用 Android 操作 系统 的 产品 销售 量 将 超过 
4000 万 台 。 

本 书 基于 Android SDK 的 1.5 版 本 ,全 面 而 详细 地 介绍 了 
Android 应 用 程序 开发 所 涉及 的 各 个 方面 内 容 , 包括 集成 开发 环境 
的 搭建 ,用 户 界 面 和 关键 组 件 的 使 用 方法 ,地 图 应 用 和 Android 
NDK 开发 等 内 容 。 从 外 到 内 、 由 表 及 里 地 介绍 了 Android 系统 的 各 
种 特性 ,将 Android 系统 的 优越 之 处 展现 在 读者 的 面前 ,通过 每 章 
的 内 容 逐 渐 引 领 读者 进入 Android 的 世界 。 

全 书 的 内 容 包括 : 

第 1 章 介绍 了 Android 平台 的 起 源 、 发 展 、 特 征 和 体系 结构 ,对 
比分 析 了 Windows Mobile, PalmOS, Symbian, Linux 和 iPhoneOS 
等 主流 手机 系统 的 优势 和 不 足 。 

第 2 章 详细 说 明了 Android 开发 环境 的 安装 与 配置 方法 ,并 对 
开发 和 调试 过 程 中 可 能 使 用 到 的 工具 进行 了 简单 的 介绍 。 

第 3 章 介 绍 了 基于 Eclipse 开发 Android 应 用 程序 的 基础 知识 
和 基本 方法 ,说 明了 Android 工程 文件 的 结构 和 用 途 ,并 介绍 了 使 
用 命令 行 开 发 、 安 装 和 运行 Android 应 用 程序 的 方法 。 

第 4 章 介 绍 了 Android 程序 的 生命 周期 和 和 进程 优先 级 的 变更 方 
式 , 并 以 Activity 为 例 说 明 Android 组 件 生 命 周期 的 状态 转换 和 事 
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件 回调 函数 的 调用 顺序 ,最 后 简单 介绍 了 Android 调试 工具 的 使 用 方法 。 

第 5 章 介绍 了 Android 用 户 界面 的 开发 方法 ,重点 介绍 了 常见 的 界面 控件 ,界面 布 
局 ,菜单 和 界面 事件 的 使 用 方法 。 

第 6 章 介绍 了 Android 系统 的 组 件 通信 机 制 , 其 中 包括 使 用 Intent 启动 组 件 的 原理 
和 方法 ,Intent 过 滤器 的 原理 与 匹配 机 制 ,广播 消息 的 接收 和 发 送 方法 等 。 

第 7 章 介 绍 了 Android 系统 的 后 台 服 务 组 件 Service, 内容 包 括 Service 的 原理 和 用 
途 ,Service 的 启动 和 绑 定 ,AIDL 语言 定义 跨 进程 服务 的 接口 ,以 及 线程 使 用 和 跨 线 程 界 
面 更 新 。 

第 8 章 介绍 了 Android 系统 所 提供 的 多 种 数据 存储 方法 ,其 中 包括 易于 使 用 的 
SharedPreferences、 经 典 的 文件 存储 和 轻 量 级 的 SQLite 数据 库 , 最 后 介绍 了 Android 系 
统 的 应 用 程序 间 数 据 共 享 接口 ContentProvider。 

第 9 章 介绍 了 位 置 服务 的 概念 和 位 置信 息 获取 方法 ,简单 说 明了 Google WA d$ 41 
的 申请 方法 ,重点 介绍 了 Google 地 图 中 的 MapView、MapController 和 Overlay 的 使 用 
方法 。 

第 10 章 介 绍 了 Android 系统 中 使 用 C/C++ 等 非 托 管 代 码 开发 应 用 程序 的 方法 ,其 
中 包括 Android NDK 的 用 途 和 优 缺 点 ,编译 环境 的 安装 与 配置 方法 ,以 及 Android NDK 
的 开发 方法 。 

第 11 章 以 “天 气 预报 短信 服务 软件 ?为 例 , 介 绍 了 Android 应 用 程序 开发 过 程 中 需 
求 分 析 、 界 面 设计 、 模 块 设计 和 程序 开发 等 步骤 ,并 简单 介绍 了 Android 应 用 程序 的 设计 
和 开发 的 思路 与 方法 。 

本 书 由 哈尔滨 工程 大 学 计算 机 科学 与 技术 学 院 王 向 辉 . 张 国 印 和 沈 洁 担任 主要 编写 
工作 。 同 时 ,参与 本 书 编写 和 校对 的 人 员 还 有 翁 岩 青 、 杜 婧 、 徐 子 涵 、 邹 新 和 马 书 亮 ,这 里 
对 他 们 的 辛苦 工作 表示 囊 心 的 感谢 。 在 本 书 的 编写 过 程 中 ,得 到 黑龙 江 省 电子 信息 产品 
监督 检验 院 王 希 患 院 长 的 热情 帮助 ,并 获得 黑龙 江 省 金 源 数码 科技 发 展 有 限 公 司 和 黑龙 
江 省 网 络 与 软件 测评 中 心 的 技术 支持 ,在 此 表示 感谢 。 

Android 是 一 个 新 兴 的 手机 平台 ,各 个 方面 还 在 不 断 地 发 展 和 变化 。 由 于 能 力 和 水 
平 所 限 ,虽然 竭尽 全 力 ,但 仍然 难免 存在 错误 和 疏漏 的 地 方 ,希望 各 位 专家 、 读 者 能 毫 不 
保留 地 提出 所 发 现 的 问题 ,与 编者 共同 讨论 ,联系 方式 是 wangxianghui@hrbeu. edu. cn。 
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Android 简介 


Android 是 一 个 优秀 的 开源 手机 平台 ,通过 本 章 的 学 习 可 以 让 读者 对 Android 平台 
的 起 源 发展. 特征 和 体系 结构 有 个 初步 的 了 解 ,然后 简要 介绍 了 Windows Mobile, 
PalmOS, Symbian, Linux 和 iPhoneOS 等 目前 主流 的 手机 操作 系统 ,了 解 各 个 主流 手机 
操作 系统 的 优势 和 不 足 。 

ASSIA: 

。 了 解 各 种 手机 操作 系统 的 特点 

。 了 解 开 放手 机 联盟 的 目的 .性 质 和 组 成 

* 了 解 Android 平台 的 发 展 历史 

。 掌握 Android 平台 的 特征 

。 掌握 Android 平台 的 体系 结构 


11 手机 操作 系统 


在 早期 的 手机 内 部 是 没有 操作 系统 的 ,所 有 的 软件 都 是 由 手机 生产 商 在 设计 时 所 定 
制 的 ,因此 手机 在 设计 完成 后 基本 是 没有 扩展 功能 的 。 后 期 的 手机 为 了 提高 手机 的 可 扩 
展 性 ,使 用 了 专 为 移动 设备 开发 的 操作 系统 ,使 用 者 可 以 根据 需要 安装 不 同类 型 的 软件 。 
虽然 使 用 操作 系统 的 手机 具有 更 好 的 可 扩展 性 ,但 由 于 操作 系统 对 于 手机 的 硬件 配置 要 
求 较 高 ,所 产生 的 硬件 成 本 和 操作 系统 成 本 使 手机 的 售 价 明显 高 于 不 使 用 操作 系统 的 手 
机 ,因此 一 般 只 有 在 高 端 智能 手机 上 使 用 手机 操作 系统 。 

目前 应 用 在 手机 上 的 操作 系统 主要 有 6 种 ,分 别 是 Windows Mobile, PalmOS, 
Symbian, Linux,iPhoneOS 和 Android, 

Windows Mobile 是 微软 推出 的 移动 设备 操作 系统 ,捆绑 了 一 系列 针对 移动 设备 而 
开发 的 应 用 软件 ,这 些 软件 构建 在 Microsoft Win32 API 基础 之 上 ,可 以 播放 音 视频 文 
件 、 浏 览 网 页 、MSN 聊天 和 收发 电子 邮件 。 由 于 该 操作 系统 对 硬件 配置 要 求 较 高 ,一 般 
需要 使 用 高 主 频 的 能 入 式 处 理 器 ,从 而 产生 了 耗 电量 大 .电池 续航 时 间 短 和 硬件 成 本 高 
等 缺点 。Windows Mobile 系列 操作 系统 包括 Smartphone, Pocket PC 和 Portable Media 
Center, Smartphone 提供 的 功能 侧重 点 在 联系 方面 ,主要 支持 的 功能 有 电话 .电子 邮件 、 
联系 人 和 即时 消息 等 。Pocket PC 的 功能 侧重 个 人 事务 处 理 和 简单 的 娱乐 ,主要 支持 的 
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功能 有 日 程 安排 .移动 版 Office 和 多 媒体 播放 功能 等 等 。Portable Media Center 提供 的 
功能 侧重 点 在 移动 多 媒体 功能 ,主要 支持 音频 播放 和 视频 播放 等 。 图 1. 1 是 Windows 
Mobile 的 用 户 界 面 。 

PalmOS 是 32 位 的 做 入 式 操作 系统 ,主要 在 移动 终端 上 使 用 。PalmOS 由 3Com 公 
司 的 Palm Computing 部 开发 ,拥有 较 多 的 第 三 方 软件 。PalmOS 在 设计 时 考虑 到 了 移动 
设备 的 内 存 相 对 较 小 ,所 以 操作 系统 本 身 所 占 的 内 存 极 小 ,基于 PalmOS 编写 的 应 用 程 
序 所 占 的 空间 也 很 小 。PalmOS 的 操作 界面 采用 触 控 式 , 基 本 所 有 的 控制 选项 都 排列 在 
屏幕 上 , 仅 使 用 手写 笔 就 可 以 完成 所 有 操作 。PalmOS 向 用 户 免 费 提供 了 开发 工具 ,允许 
用 户 利用 该 工具 编写 或 修改 相关 软件 ,使 支持 PalmOS 的 应 用 程序 丰富 多 彩 。PalmOS 
在 其 他 方面 还 存在 一 些 不 足 , 例 如 自身 不 具有 录音 和 MP3 播放 功能 ,如 果 需 要 使 用 这 些 
功能 ,还 需要 加 入 第 三 方 软件 或 硬件 设备 方 可 实现 。 图 1.2 是 PalmOS 的 用 户 界面 。 
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1.1 Windows Mobile 的 用 户 界面 1.2 PalmOS 的 用 户 界面 


Symbian 是 为 手机 而 设计 的 实时 多 任务 32 位 操作 系统 ,提供 了 开发 使 用 的 函数 库 、 
用 户 界面 .通用 工具 和 参考 示例 。Symbian 操作 系统 由 Symbian 公司 负责 开发 与 维护 ， 
2008 年 12 月 2 日 ,诺基亚 收购 了 Symbian 公司 。Symbian 操作 系统 具有 功 耗 低 、 内 存 占 
用 少 等 特点 ,适合 手机 等 移动 设备 使 用 ,而 且 有 灵活 的 应 用 界面 框架 ,不 但 使 程序 开发 人 
员 可 以 快速 地 掌握 关键 技术 ,还 可 以 使 手机 制造 商 推出 不 同 界面 的 产品 。 经 过 不 断 完 
善 ,Symbian 操作 系统 已 经 可 以 支持 3G .GPRS 和 蓝牙 等 功能 。Symbian 操作 系统 并 不 
是 完全 开放 的 , 它 并 没有 开放 核心 代码 ,核心 代码 仅 可 以 提供 给 使 用 Symbian 操作 系统 
的 手机 制造 商 和 其 他 合作 伙伴 。 但 Symbian 操作 系统 提供 公开 的 API 文 档 , 任 何人 都 可 
以 开发 用 于 Symbian 操作 系统 的 应 用 软件 。 图 1. 3 是 Symbian 的 用 户 界 面 。 

Linux 手机 操作 系统 是 由 计算 机 Linux 操作 系统 演变 而 来 的 。 在 Linux 成 为 移动 终 
端的 操作 系统 后 ,就 以 其 开放 源 代码 的 优势 吸引 了 越 来 越 多 的 终端 厂商 和 运营 商 的 关 
注 。Linux 开放 源 代 码 的 特性 不 仅 能 够 大 幅度 地 降低 手机 的 软件 成 本 ,还 有 利于 独立 软 
件 开发 商 开发 出 硬件 利用 效率 高 功能 更 强大 的 应 用 软件 ,行业 用 户 开 发 出 安全 、 可 靠 的 
应 用 系统 ;同时 ,开源 也 满足 了 手机 制造 商定 制 Linux 手机 操作 系统 的 要 求 ,吸引 了 众多 
软件 开发 商 ,丰富 了 第 三 方 应 用 。 然 而 ,Linux 操作 系统 有 其 先天 的 不 足 。 首 先 , 人 门 难 
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度 高 ,熟悉 其 开发 环境 的 工程 师 少 ,而 且 集成 开发 环境 较 差 ;其 次 ,由 于 微软 操作 系统 
源 代码 的 不 公开 ,基于 Linux 的 产品 与 个 人 计算 机 的 连接 性 较 差 ; 最 后 ,尽管 目前 从 事 
Linux 操作 系统 开发 的 公司 数量 较 多 ,但 真正 具有 很 强 开发 实力 的 公司 却 很 少 ,而 且 这 
些 公司 之 间 是 相互 独立 开发 的 ,很 难 实现 更 大 的 技术 突破 。 图 1.4 是 Linux 的 用 户 
界面 。 
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图 1.3 Symbian 的 用 户 界面 图 1.4 Linux 的 用 户 界面 


iPhoneOS 是 由 苹果 公司 为 iPhone 开发 的 操作 系统 ,以 开放 源 代 码 的 操作 系统 
Darwin 为 基础 ,主要 是 供 苹 果 公 司 生 产 的 iPhone 手机 和 MP4 播放 器 iPod touch 使 用 。 
iPhoneOS 的 系统 架构 分 为 4 个 层次 ,分 别 是 核心 操作 系统 层 、 核 心服 务 层 .媒体 层 和 可 
Gab rf iPhone 应 用 程序 开发 ,苹果 公司 提供 了 iPhone SDK. iPhone 应 用 
程序 进行 开发 .测试 .运行 和 调试 提供 工具 。 多 点 触摸 操作 是 iPhoneOS 的 用 户 界 面 基 
础 ,也 是 iPhoneOS 区 别 与 其 他 手机 操作 系统 的 特性 之 一 ,支持 的 控制 方法 包括 滑动 、 轻 
Tü . 挤 压 和 旋转 。 此 外 ,iPhoneOS 还 通过 支持 内 置 加 速 器 ,允许 系统 界面 根据 屏幕 的 方 
向 而 改变 方向 。iPhoneOS 自 带 大 量 的 应 用 程序 , 包 
括 SMS 简讯 .日 历 、 相 机 、YouTube、 股 市 .地 图 、 天 
"DÉI ETE di ok .系统 设 定 ,iTunes 和 通讯 录 
等 。 图 1.5 是 iPhoneOS 的 用 户 界 面 。 

Android 也 是 一 种 手机 操作 系统 ,是 谷歌 
(Google) 发 布 的 基于 Linux 的 开源 手机 平台 ,该 平台 
1 操作 系统 、 中 间 件 、 用 户 界面 和 应 用 软件 组 成 ,是 第 
一 个 可 以 完全 定制 .免费 .开放 的 手机 平台 。 区 别 于 
上 述 几 个 手机 操作 系统 ,Android 是 一 个 完全 免费 的 
手机 平台 ,使 用 Android 并 不 需要 授权 费 ,而 且 因为 
Android 平台 有 丰富 的 应 用 程序 ,也 大 幅度 降低 了 应 
用 程序 的 开发 费用 ,可 以 节约 15% — 20% EY BIL ril xs 
RÆ. Android 底层 使 用 开源 的 Linux 操作 系统 , 同 
时 开放 了 应 用 程序 开发 工具 ,使 所 有 程序 开发 人 员 都 全 i 
在 统一 .开放 的 开发 平台 上 进行 开发 ,保证 了 Android 图 1.5 iPhoneOS 的 用 户 界 面 
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应 用 程序 的 可 移植 性 。Android 平台 使 用 Java 语言 进行 开发 ,支持 SQLite 数据 库 、 
2D/3D 图 形 加 速 、 多 媒体 播放 和 摄像 头等 硬件 设备 ,并 内 置 了 丰富 的 应 用 程序 ,如 电子 邮 
TEE Pisis BP Web 浏览 器 .计时 器 .通讯 录 和 MP3 播放 器 等 。 图 1.6 是 Android 的 用 
户 界 面 。 


(a) 系统 桌面 (b) 程序 菜单 
1.6 Android 的 用 户 界面 
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121 开放 手机 联盟 


说 到 Android 的 发 展 史 , 首 先 要 介绍 Android 平台 的 推动 者 一 一 开放 手机 联盟 
(Open Handset Alliance,OHA)。 开 放手 机 联盟 是 美国 谷歌 公司 于 2007 年 发 起 的 一 个 
全 球 性 的 联盟 组 织 , 目 标 是 研发 移动 设备 的 新 技术 ,用 以 大 幅 削 减 移动 设备 开发 与 推广 
成 本 。 同 时 通过 联盟 各 个 合作 方 的 努力 ,建立 了 移动 通信 和 领域 新 的 合作 环境 ,促进 了 创 
新 移动 设备 的 开发 ,创造 了 目前 移动 平台 实现 的 用 户 体验 。 

开放 手机 联盟 成 立时 由 34 个 成 员 组 织 构成 ,包括 电信 运营 商 、. 半 导体 芯片 商 . 手 机 
硬件 制造 商 .软件 厂商 和 商品 化 公司 等 5 类 ,涵盖 移动 终端 产业 链 各 个 环节 。 目 前 ,开放 
手机 联盟 的 成 员 组 织 数 目 已 经 增加 到 50 个 。 谷 歌 通过 与 运营 商 \、 设 备 制造 商 , 开 发 商 和 
其 他 有 关 各 方 结 成 深层 次 的 合作 伙伴 关系 ,借助 建立 标准 化 、 开 放 式 的 移动 电话 软件 平 
台 ,在 移动 产业 内 形成 一 个 开放 式 的 生态 系统 。 

在 开放 手机 联盟 的 组 织 成 员 中 ,电信 运营 商 主 要 有 中 国 移动 通信 、KDDI( 日 本 )、 
NTT DoCoMo( 日 本 )、Sprint Nextel( 美 国 )、T-Mobile( 美 国 )、Telecom( 意 大 利 ) .中 国联 
通 、Softbank( 日 本 )、Telefonica( 西 班 牙 ) 和 Vodafone( 英 国 ) ,如 图 1.7 所 示 。 

开放 手机 联盟 中 的 半导体 芯片 商 有 Audience( 美 国 )、AKM( 日 本 )、ARM( 英 国 )、 
Atheros Communications( 美 国 ) , Broadcom (美国 ) .Intel( 美 国 ) .Marvell( 美 国 ) .nVIDIA 
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图 1.7 电信 运营 商 


(美国 ) .Qualcomm( 美 国 ) SIRF CS FD) , Synaptics CX ED) , ST-Eriesson CER LH. y E Al 
瑞典 ) 和 Texas Instruments 3% E ) ,如 图 1. 8 所 示 。 
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图 1.8 半导体 芯片 商 


开放 手机 联盟 中 的 手机 硬件 制造 商 有 Acer( 中 国 台湾 ) .华硕 (中 国 台湾 )、.Garmin 
(中 国 台湾 ) ,宏达电 (中 国 台湾 )、LG( 韩 国 ) 、 = 星 (韩国 )、. 华 为 (中 国 ) .摩托 罗拉 (美国 )、 
索尼 爱立信 (日 本 和 瑞典 ) 和 东芝 (日 本 ) ,如 图 1.9 所 示 。 
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1.9 手机 硬件 制造 商 


开放 手机 联盟 中 的 软件 厂商 有 Ascender Corp (美国 )、eBay (美国 ) .谷歌 (美国 )、 
LivingImage( 日 本 )、NuanceCommunications (美国 )、Myraid (瑞士 )、Omron (日 本 )、 
PacketVideo( 美 国 )、SkyPop( 美 国 ) ,Svox(m +) M SONIVOX( 美 国 ) ,如 图 1. 10 所 示 。 
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图 1.10 软件 厂商 


开放 手机 联盟 中 的 商品 化 公司 有 Aplix Corporation( H ki, Noser Engineering (Si 
士 )、Borqs( 中 国 )、TAT-The Astonishing (瑞典 )、Teleca AB (Fig HL) 和 Wind River( 美 
国 ) ,如 图 1. 11 所 示 。 
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图 1.11 商品 化 公司 
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2007 年 11 月 5 日 ,开放 手机 联盟 成 立 , 由 电信 运营 商 、. 半 导体 芯片 商 . 手 机 硬件 制造 
商 、 软 件 厂商 和 商品 化 公司 在 内 的 34 个 组 织 构 成 ,推动 
Android 平台 的 研发 和 推广 。 开 放手 机 联盟 徽标 如 图 1. 12 
所 示 。 

2007 年 11 H 12 H fi T Android SDK 预览 版 ,这 
是 第 一 个 对 外 公布 的 Android SDK ,为 发 布 正式 版 收集 用 
户 反馈 。 

2008 年 4 月 17 日 ,谷歌 举办 总 共 1000 万 美金 的 
Android 开发 者 竞赛 ,奖励 最 有 创意 的 Android 程序 开发 
者 ,使 Android 平台 在 短 时 间 积 累 了 大 量 优秀 的 应 用 程序 。 1.12 开放 手机 联盟 微 标 
涌现 出 像 cab4me (出 租车 呼叫 )、BioWallet (生物 特征 识 
别 ) 和 CompareEverywhere( 实 时 商品 查询 ) 等 极 具 创 意 的 应 用 程序 ,如 图 1.13 所 示 。 


cab4me light - select pickup location 


图 1.13 Android 开发 者 竞赛 作品 


2008 年 8 月 28 日 ,谷歌 开通 了 Android Market, DE Android 手机 下 载 需 要 使 用 的 应 
用 程序 。 程 序 开 发 人 员 可 以 将 自己 设计 的 Android 软件 上 传 到 Android Market (如 
图 1. 14 所 示 ) ,并 决定 软件 是 否 收取 费用 。 但 在 Android Market 上 销售 软件 需要 向 谷歌 
支付 25 美元 的 注册 费 , 并 在 每 次 交易 中 将 30% 的 利润 支付 给 运营 商 。 

2008 4p 9 H 23 H Em Android SDK v1. 0 版 ,这 是 第 一 个 稳定 的 SDK 版 本 。 
SDK 中 分 别提 供 了 基于 Windows, Mac 和 Linux 操作 系统 的 集成 开发 环境 ,包含 完整 
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高 效 的 Android 模拟 器 和 开发 工具 ,详尽 的 说 明文 档 和 开发 示例 。 程 序 开 发 人 员 非 常 
容易 就 可 以 掌握 Android 应 用 程序 的 开发 方法 ,同时 也 降低 了 开发 手机 应 用 程序 的 
门槛 。 


CINDROID 
> Android Market 


Check out our site for some of the more popular applications and games available in Android Market. For a comprehensive, up-to-date list of the thousands of titles 
that are available, you will need to view Android Market on a handset 
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1.14 Android Market 


2008 4E 10 H 22 日 ,第 一 款 Android 手机 T-Mobile G1( HTC Dream) 在 美国 上 市 ， 
由 中 国 台湾 的 宏达电 CHTC) 制 造 , 如 图 1.15 所 示 。 在 硬件 方 
面 , 内 置 528MHz 的 Qualcomm MSM 7201A 处 理 器 ,有 192MB 
RAM 和 256MB ROM 的 内 存 空间 ,提供 侧面 滑动 的 全 键盘 , 支 
持 Wi-Fi Dy fE RP] GPS 模块 ,支持 最 大 8GB 容量 的 microSD 
存储 卡 扩展 容量 ,支持 GSM/UMTS/GPRS/EDGE/HSDPA 网 
络 ,在 软件 方面 ,集成 了 众多 的 应 用 功能 ,包括 谷歌 的 地 图 功 
HE. YouTube 视频 功能 、 全 方位 的 导航 定位 以 及 360 度 查看 浏 
览 目标 位 置 的 功能 。 

2008 年 10 月 21 日 ,谷歌 开放 了 Android 平台 的 源 代 码 。 1.15 T-Mobile G1 
Android 作为 开放 源 代码 的 手机 平台 ,任何 人 或 机 构 都 可 以 免 
费 使 用 Android, 并 对 它 做 出 改进 。 开 放 源 代码 的 Android 有 利于 创新 ,能 够 为 用 户 提 
供 更 好 的 体验 。 同 时 也 意味 着 任何 厂商 都 可 以 推出 基于 Android 的 手机 , 且 不 用 支付 
任何 的 许可 费用 。Android 的 源 代码 可 以 到 谷歌 的 官方 网 站 下 载 , 地 址 是 http:// 
source. android. com/ download, 如 图 1. 16 所 示 。 

2009 年 2 月, 发布 Android SDK vi. 1 版。 修正 原 有 版 本 存在 的 缺陷 ,如 设备 休眠 状 
态 的 稳定 性 问题 .邮件 冻结 问题 .POP3( 第 3 代 邮 局 协议 ) 链 接 失败 问题 和 IMAP( 因 特 网 
邮件 访问 协议 ) 的 密码 引用 问题 等 。 同 时 ,增加 了 新 的 特性 ,例如 当 用 户 搜索 地 图 或 详细 
查看 时 ,允许 用 户 对 地 图 进行 评论 ;允许 用 户 保 存 彩 信 的 附件 ;为 了 更 加 便利 的 使 用 拨号 
盘 , 可 以 将 拨号 盘 隐 藏 或 显示 在 通话 菜单 中 。 
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图 1.16 Android 源 代 码 的 下 载 网 站 


2009 年 2 月 17 日 ,第 二 款 Android 手 机 T-Mobile G2CHTC Magic) 正 式 发 售 , 仍 然 
由 中 国 台湾 的 宏达电 制造 。T-Mobile G2( 见 图 1. 17) 的 硬件 配置 与 T-Mobile G1 基本 相 
f] ,不 同 之 处 主要 在 于 将 256MB ROM 的 内 存 空间 提高 到 512MB ,并 略微 增加 了 的 电池 
的 容量 ,用 以 提升 整 机 的 使 用 时 间 。T-Mobile G1 放弃 了 影响 手机 尺寸 的 滑动 全 键盘 设 
计 , 使 T-Mobile G2 fy [f f (113mm X 55mm X 13. 65mm) 比 T-Mobile G1(117. 7mm X 
55. 7mm X 17. lmm) 明 显 减 小 。 

2009 年 4 月 15 日 ,发 布 Android SDK v1.5 版 。 此 版 本 SDK 提升 了 性 能 表现 ,提高 
了 摄像 头 的 启动 速度 和 拍摄 速度 ,提高 了 GPS 位 置 的 获取 速度 ,使 浏览 器 的 深 动 更 为 平 
iB ,提高 了 获取 Gmail 中 对 话 列 表 的 速度 等 。 在 新 特性 方面 ,支持 了 软 键 盘 、 中 文 显示 和 
中 文 输入 功能 ,并 可 以 将 视屏 录制 的 内 容 直 接 上 传 到 Youtube。 

2009 4E 6 H 24 日 ,中 国 台 湾 的 宏达电 发 布 了 第 三 款 Android 手机 HTC Hero( 见 
图 1. 18) ,在 硬件 方面 ,使 用 Qualcomm MSM 7200A 处 理 器 ,500 万 像素 摄像 头 ,提供 
3. 5mm 的 耳机 插 孔 。 在 软件 方面 ,首次 支持 Adobe Flash 和 支持 多 点 触 控 技 术 , 最 突出 的 
改进 是 使 用 了 HTC Sense 界面 ,使 HTC Hero 的 界面 异常 美观 .绚丽 。 


图 1.17 T-Mobile G2 图 1.18 HTC Hero 
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Android 广泛 支持 GSM( 全 球 通 ) ,DEGE 和 3G 的 语音 与 数据 业务 ,支持 接收 语言 呼 
叫 和 SMS( 短 信 消 息 服务 ) ,支持 数据 存储 共享 和 IPC( 进 程 间 通信 ) 消 息 机 制 ,为 地 理 位 
置 服务 (如 GPS) .谷歌 地 图 服务 提供 易于 使 用 的 API 函数 库 ,提供 组 件 复 用 和 内 置 程序 
替换 的 应 用 程序 框架 ,提供 基于 WebKit 的 浏览 器 ,广泛 支持 各 种 流行 的 音频 和 视频 文件 
格式 ,支持 的 格式 有 MPEG4,H264,MP3,AAC,AMR,JPG,PNG 和 GIF, X 2D 和 3D 
图 像 处 理 的 专用 的 API 库 函 数 。 

Android 系统 提供 了 访问 硬件 的 API 库 函 数 , 用 来 简化 像 摄 像 头 .GPS 等 硬件 的 访 
问 过 程 。 只 要 支持 Android 应 用 程序 框架 的 手机 ,对 硬件 访问 的 方法 是 完全 一 致 的 , 因 
此 即使 将 应 用 程序 移植 到 不 同 硬件 配置 的 手机 上 ,也 无 需 修改 应 用 程序 对 硬件 的 访问 方 
ik. Android 支持 的 硬件 包括 GPS 摄像头、 网 络 连接 `Wi-Fi、 蓝 牙 . 加 速度 计 、 触 摸 屏 和 
电源 管理 等 。 

在 内 存 和 进程 管理 方面 ,Android 具有 自己 的 运行 时 和 虚拟 机 。 与 Java 和 .NET 运 
行 时 不 同 ,Android 运行 时 还 可 以 管理 进程 的 生命 周期 。Android 为 了 保证 高 优先 级 进 
程 运行 和 正在 与 用 户 交互 进程 的 响应 速度 ,允许 停止 或 终止 正在 运行 的 低 优先 级 进程 ， 
以 释放 被 占用 的 系统 资源 。Android 进程 的 优先 级 并 不 是 固定 的 ,而 是 根据 进程 是 否 在 
前 台 或 是 否 与 用 户 交互 而 不 断 变化 的 。Android 生命 周期 和 调试 的 相关 内 容 将 在 本 书 的 
第 4 章 进 行 介绍 。 

在 界面 设计 上 ,Android 提供 了 丰富 了 界面 控件 供 使 用 者 之 间 调 用 ,从 而 加 快 了 用 户 
界面 的 开发 速度 ,也 保证 了 Android 平台 上 的 程序 界面 的 一 致 性 。Android 将 界面 设计 
与 程序 逻辑 分 离 方面 ,使 用 XML 文件 对 界面 布局 进行 描述 ,有 利于 界面 的 修改 和 维护 。 
用 户 界面 的 相关 内 容 将 在 本 书 的 第 5 章 进行 介绍 。 

Android 提供 轻 量 级 的 进程 间 通 信 机 制 Intent, 使 跨 进程 组 件 通 信和 和 发送 系统 级 广 
播 成 为 可 能 。 通 过 设置 组 件 的 Intent 过 滤器 ,组 件 通 过 匹配 和 筛选 机 制 ,可 以 准确 地 获 
取 到 可 以 处 理 的 Intent。 组 件 通信 和 与 广播 消息 的 相关 内 容 将 在 本 书 的 第 6 章 进 行 介绍 。 

Android 提供 了 Service 作为 无 用 户 界面 .长 时 间 后 台 运 行 的 组 件 。Android 是 多 任 
务 系统 , 但 受到 屏幕 尺寸 的 限制 ,同一 时 刻 只 允许 一 个 应 用 程序 是 在 前 台 运 行 。 
Service 无 需 用 户 干预 ,可 以 长 时 间 、 稳 定 地 运行 ,可 为 应 用 程序 提供 特定 的 后 台 功 能 ， 
还 可 以 实现 事件 处 理 或 数据 更 新 等 功能 。 后 台 服 务 相 关内 容 将 在 本 书 的 第 7 章 进行 
介绍 。 

Android 支持 高 效 . 快速 的 数据 存储 方式 ,包括 快速 数据 存储 方式 
SharedPreferences 文件 存储 和 轻 量 级 关系 数据 库 SQLite, 应 用 程序 可 以 使 用 适合 的 方 
法 对 数据 进程 保存 和 访问 。 同 时 ,为 了 便于 路 进程 共享 数据 ,Android 提供 了 通用 的 共享 
数据 接口 ContentProvider ,可 以 无 需 了 解数 据 源 .路 径 的 情况 下 ,对 共享 数据 进行 查询 、 
添加 删除 和 更 新 等 操作 。 数 据 存储 与 访问 相关 内 容 将 在 本 书 的 第 8 章 进行 介绍 。 
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14 Andad 体系 结构 


Android 是 基于 Linux 内 核 的 软件 平台 和 操作 系统 ,采用 了 软件 堆 层 (Software 
Stack) 的 架构 , 共 分 为 4 层 。 第 1 层 是 Linux 内 核 ,提供 由 操作 系统 内 核 管理 的 底层 基础 
功能 ;第 2 层 是 中 间 件 层 , 由 函数 库 和 Android 运行 时 构成 ;第 3 层 是 应 用 程序 框架 层 , 提 
HET Android 平台 基本 的 管理 功能 和 组 件 重 用 机 制 ; 第 4 层 是 应 用 程序 层 ,提供 了 一 系 
列 核 心 应 用 程序 ,如 图 1. 19 所 示 。 


应 用 程序 
[wore a | na | ( um | ( amem ) [ =] 
应 用 程序 框架 
Activity Window Content View 
Manager Manager Providers | System | 
Package Telephony Resource Location Notification 
Manager Manager Manager Manager Manager 
函数 库 Android 运行 时 
Surface (Media ; 
Manager | Framework ] | SQLite | 
Dalvik 虚拟 机 
| OpenGL rs | FreeType | WebKit | 
| SGL | SSL ) | libc | 
Linux 内 核 
| 安全 机 制 】 [ 内 在 管理 | ane | [een ] 
( 电源 管理 | Wi-Fi 驱 动 | ( san | [ T | 


图 1.19 Android 体系 结构 


Android 平台 的 底层 使 用 的 是 Linux 2. 6 内 核 ,硬件 和 其 他 软件 堆 层 之 间 的 一 个 抽 
象 隔离 层 。 提 供 安全 机 制 ,内存 管理 .进程 管理 .网 络 协议 堆栈 .电源 管理 和 驱动 程序 等 ， 
驱动 程序 包括 Wi-Fi 驱动 .声音 驱动 .显示 驱动 .摄像头 驱 动 .闪存 驱动 .Binder(IPC) 驱 动 
和 键盘 驱动 等 。 

函数 库 在 Linux 内 涵 之 上 ,提供 了 一 组 基于 C/C++ 的 函数 库 ,程序 开发 人 员 可 以 通 
过 应 用 程序 框架 调用 这 些 函 数 库 。 主 要 的 函数 库 包 括 : Surface Manager, 支 持 显 示 子 系 
统 的 访问 ,为 多 个 应 用 程序 提供 2D. 3D 图 像 层 的 平滑 连接 ; Media Framework, 基于 
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OpenCORE 的 多 媒体 框架 ,实现 音频 视频 的 播放 和 录制 功能 ,广泛 支持 多 种 流行 的 音 视 
频 格式 ,包括 MPEG4、H. 264、MP3、AAC、AMR、JPG fll PNG 等 ;SQLite, 轻 量 级 的 关系 
数据 库 引擎 ;OpenGL ES, 基 于 硬件 的 3D 图 像 加 速 ; FreeType, 位 图 与 矢量 字体 泻 染 ; 
WebKit. Web 浏览 器 引擎 ;SGL,2D 图 像 引 擎 ;SSL ,数据 加 密 与 安全 传输 的 函数 库 ;libc， 
标准 C 运行 库 , 它 是 Linux 系统 中 底层 的 应 用 程序 开发 接口 。 

Android 运行 时 由 核心 库 和 Dalvik 虚拟 机 构成 。 核 心 库 为 程序 开发 人 员 提 供 了 
Android 系统 的 特有 函数 功能 和 Java 语言 基本 函数 功能 。Dalvik 虚拟 机 是 经 过 优化 的 
多 实例 虚拟 机 ,基于 寄存 器 架构 设计 ,实现 了 基于 Linux 内 核 的 线程 管理 和 底层 内 存 管 
理 。Dalvik 虚拟 机 可 以 执行 Dalvik 可 执行 格式 (. dex) ,该 格式 适合 内 存 和 处 理 器 速度 受 
限 的 系统 。 

应 用 程序 框架 提供 了 Android 平台 基本 的 管理 功能 和 组 件 重用 机 制 ,包括 Activity 
管理 、 窗 体 管理 , 包 管理 .电话 管理 ,资源 管理 ,位 置 管理 .通知 消息 管理 、View 系统 和 内 
容 提 供 者 等 。ContentProvider 用 来 共享 私有 数据 ,实现 跨 进 程 的 数据 访问 ,Resource 
Manager 人 允许 应 用 程序 使 用 非 代码 资源 ,如 图 像 , 布 局 和 本 地 化 的 字符 串 等 ;Notification 
Manager 允许 应 用 程序 在 状态 栏 中 显示 提示 信息 ;Activity Manager 用 来 管理 应 用 程序 
的 生命 周期 ;Window Manager 用 来 启动 应 用 程序 的 窗 体 ;Location Manager 用 来 管理 与 
地 图 相关 的 服务 功能 ; Telephony Manager 用 来 管理 与 拨打 和 接听 电话 相关 的 功能 ; 
Package Manager 用 来 管理 安装 在 Android 系统 内 的 应 用 程序 。 

应 用 程序 提供 了 一 系列 核心 应 用 程序 ,包括 电子 邮件 客户 端 .浏览 器 .通讯 录 和 日 历 
等 等 。 


SI E 
l. 简 述 6 种 主流 的 手机 操作 系统 的 特点 。 


2. 简 述 Android 平台 的 特征 。 
3. 描述 Android 平台 体系 结构 的 层次 划分 ,并 说 明 各 个 层次 的 作用 。 
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Android 开发 环境 


Android 开发 环境 的 安装 与 配置 是 开发 Android 应 用 程序 的 第 一 步 ,也 是 深入 
Android 平台 的 一 个 非常 好 的 机 会 。 通 过 本 章 的 学 习 , 读 者 可 以 完全 掌握 安装 .配置 
Android 开发 环境 的 步骤 和 注意 事项 ,熟悉 Android SDK 和 ADT 插件 的 用 途 , 了 解 在 应 
用 程序 开发 过 程 中 可 能 会 使 用 到 的 各 种 工具 。 

本 章 学 习 目 标 : 

。 掌握 Android 开发 环境 的 安装 配置 方法 

* 了 解 Android SDK 的 目录 结构 和 示例 程序 

。 了 解 Android 开发 工具 
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Eclipse 是 开发 Android 应 用 程序 的 首选 集成 开发 环境 。Eclipse 作为 开源 的 Java 开 
发 环境 ,功能 强大 易于 使 用 ,而 且 还 提供 了 在 Eclipse 上 开发 Android 应 用 程序 的 ADT 
(Android Development Toolkit) 插 件 , 简 化 了 Android 应 用 程序 的 开发 .运行 和 调试 。 

安装 Android 开发 环境 ,首先 需要 安装 支持 Java 应 用 程序 运行 的 Java 开发 工具 包 
(Java Development Kit. JDK) ,然后 安装 集成 开发 环境 Eclipse, 最 后 安装 Android SDK 
FI Eclipse 的 ADT 插件 。 


211 安装 JOK 和 Eclipse 


在 开始 下 载 和 安装 Eclipse 之 前 ,应 该 首先 确认 开发 主机 上 是 否 已 经 安装 了 Java 运 
行 环境 (Java Runtime Environment,JRE)。 因 为 Eclipse 是 用 Java 语言 编写 的 应 用 程 
序 , 需 要 JRE 才能 运行 。 如 果 JRE 没有 安装 或 者 没有 被 检测 到 ,尝试 打开 Eclipse 时 会 
有 错误 提示 ,如 图 2. 1 所 示 。 

安装 JRE 的 系统 可 以 运行 Java 应 用 程序 ,但 如 果 需 要 开发 Java 应 用 程序 , 则 应 该 直 
接 安装 JDK ,因为 JDK 中 包括 完整 的 JRE, 安 装 JDK 时 JRE 也 被 装 入 到 操作 系统 中 。 
JDK 的 基本 组 件 包括 编译 器 ,将 源 程 序 转换 成 字 节 码 ; 打 包工 具 , 将 相关 的 类 文件 打包 成 
一 个 文件 ;文档 生成 器 ,从 源码 注释 中 提取 文档 : 查 错 工具 ,用 来 进行 调试 和 查 错 。 
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A Java Runtime Environment (JRE) or Java Development Kit DK) 
must be available in order to run Eclipse. No Java virtual machine 
was found after searching the following locations: 


E: \Androi d\eclipse\jre\bin\ javaw. exe 
javaw.exe in your current P. 


图 2.1 没有 安装 JRE 的 错误 提示 


Fa JDK 可 以 在 浏览 器 输入 http://java. sun. com/javase/downloads/index. jsp. É 
接 进 入 Sun 的 JavaSE 下 载 页 面 ,选择 下 载 JDK6 Update 14, 如 图 2.2 所 示 。 


Java SE Development Kit 


JDK 6 Update 14 


This release is Windows 7 support-ready and includes support for Internet 

Explorer 8, Windows Server 2008 SP2, and Windows Vista SP2. New Docs ¥ 
features include the G1 garbage collector, plus performance and security 
enhancements, » Learn more 


Java SE Runtime Environment 


JRE 6 Update 14 


This release is Windows 7 support-ready and includes support for Internet 
Explorer 8, Windows Server 2008 SP2, and Windows Vista SP2. New Docs v. 
features include the G1 garbage collector, plus performance and security 
enhancements. ” Learn more 


Java SE for Business 


JRE or JDK 6, 5.0, or 1.4.2 | Download | 


Faster access to critical fixes, a longer support roadmap, and enterprise 
features designed to reduce the cost of deployment. Each JRE or JDK 
version you select for download is made available in binary format and 
includes the related license files and other documents. 


2.2 JavaSE 下 载 页 面 


单 击 Download 按钮 ,进入 JKD 平台 和 语言 选择 页 面 ,选择 的 平台 为 Windows. ili zi 
为 Multi-language, 如 图 2. 3 所 示 。 


Provide Information, ontinue to Download 


Select Platform and Language for your download: 


Platform: 
Language: | Multi-language «| 


[V] 1agree to the Java SE Development Kit 6u1 4 License Agreement 


图 2.3 JKD 平台 和 语言 选择 页 面 


最 后 进入 JDK 下 载 页 面 ,下 载 jdk-6ul4-windows-i586. exe 文件 ,如 图 2.4 所 示 。 

在 JDK 的 安装 过 程 中 ,一 般 情况 下 保持 JDK 的 默认 设置 即 可 ,JDK 会 安装 在 C:\ 
Program File\Java\jdk1. 6.0_14\ 目 录 下 ,如 图 2.5 Pra. 

JDK 安装 完毕 后 ,安装 程序 会 提示 “Java(TM) SE Development Kit 6 Update 14 已 
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Download Information and Files 


Instructions: Select the files you want, then click the "Download Selected with Sun Download 
Manager" (SDM) button below to automatically install and use SDM (learn more). Alternately, click 
directly on file names to download with your browser. (Use of SDM is recommended but not 
required.) 


Available Files 


File Description and Name Size 


Java SE Development Kit 6u14 73.48 MB 
© jdk-6ut 4-windows-i586.exe 


图 2.4 JDK 下 载 页 面 


Cl Java(TM) SE Development Kit 6 Update 14 — 自 定义 安装 


自 定义 安装 
选择 要 安装 的 程序 功能 。 


请 从 下 面 的 列表 中 选择 要 安装 的 可 选 功能 。 安 装 完成 后 ， 您 可 以 使 用 "控制 面板 "中 的 ' 添 加 / 
删除 程序 “实用 程序 来 更 改 您 选择 的 功能 


安装 到 : \ J 
C:\Program Files\Java\jdk1.6.0_14) 


2.5 JDK 的 默认 设置 


经 成 功 安 装 ”, 如 图 2.6 所 示 。 下 一 步 可 以 进行 Eclipse 的 安装 工作 了 。 
Cl Java(TM) SE Development Kit 6 Update 14 — 5 


Java(TM) SE Development Kit 6 Update 14 
CR AE ` ° 


产品 注册 是 免费 的 ,您 将 获得 如 下 增值 服务 : 

* 获得 新 版 本 、 修 补 程序 和 更 新 的 通知 服务 

* 获得 有 关 Sun 开发 者 产品 、 服 务 和 培训 的 忧 囊 
* 获 得 对 早期 版 本 和 文档 的 访问 权限 


当 您 单 击 " 完 成 "后 格 收集 产品 与 系统 信息 ， 同 时 显示 IDK 
产品 注册 表单 。 如 果 您 不 注册 ， 则 不 保存 以 上 信息 。 


有 关注 册 所 收集 的 数据 以 及 这 些 数据 的 
管理 和 使 用 方式 的 更 多 信息 ， 
请 参见 产品 注册 信息 "页 面 。 


CC 


图 2.6 JDK 安装 成 功 界面 
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下 载 Eclipse 可 以 在 浏览 器 输入 http://www. eclipse. org/downloads, ,进入 Eclipse 
网 站 的 主页 面 ,选择 下 载 “Eclipse IDE for Java Developers (92MB)” HY Windows 版 本 ,如 
图 2.7 所 示 。 


Eclipse IDE for Java EE Developers (189 MB) Windows 

Tools for Java developers creating Java EE and Web applications, including a Java IDE, Mac Carbon 32bit 
tools for Java EE, JPA, JSF, Mylyn and others. More... Mac Cocoa 32bit 
Downloads: 564,432 Linux 32bit 64bit 


The essential tools for any Java developer, including a Java IDE, a CVS client, XML Editor Mac Carbon 32bit 
and Mylyn. More... Mac Cocoa 32bit 
Downloads: 219,666 Linux 32bit 64bit 
Eclipse for PHP Developers (139 MB) Windows 

Tools for PHP developers creating Web applications, including PHP Development Tools Mac Carbon 32bit 
(PDT), Web Tools Platform, Mylyn and others. More... Mac Cocoa 32bit 
Downloads: 128,090 Linux 32bit 64bit 


a 

(JEE 

ch Eclipse IDE for Java Developers (92 MB) Windows 
K 


2.7 Eclipse 下 载 页 面 


下 载 的 Eclipse 是 一 个 ZIP 文件 ,文件 名 为 eclipse-java-galileo-win32. zip. 直接 将 
ZIP 文件 中 的 eclipse 文件 夹 解压 缩 到 指定 的 目录 中 即 可 。 双 击 目录 中 的 eclipse. exe X 
件 , 出 现 Eclipse 集成 开发 环境 的 启动 画面 ,如 图 2. 8 所 示 。 如 果 没 有 出 现 启动 画面 ,可 
以 尝试 重新 启动 计算 机 。 


Tree 


GALILEO 


2.8 Eclipse 启动 画面 


Eclipse 启动 时 会 提示 选择 一 个 默认 工作 目录 ,以 后 创建 的 工程 将 保存 在 这 个 工作 目 
录 下 。 工 作 目 录 的 默认 路 径 是 用 户 目录 ,建议 用 户 选 择 其 他 位 置 保存 Android 工程 。 作 
者 选择 的 工作 目录 是 E\ Android\workplace, 如 图 2.9 所 示 。 建 议 选择 复 选 框 Use this 
as the default and do not ask again ,将 选择 的 工作 目录 作为 默认 工作 目录 ,不 必 每 次 启动 
时 都 重新 选择 工作 目录 。 

正常 启动 后 的 Eclipse 集成 开发 环境 如 图 2. 10 所 示 。 

到 此 为 止 ,Eclipse A JDK 已 经 安装 完毕 ,但 在 创建 Android 工程 之 前 ,还 需要 下 载 
和 安装 Android SDK 和 ADT 的 插件 ,并 完成 Eclipse 的 相关 设置 。 


© Workspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace 
Choose a workspace folder to use for this session. 


E: \Android\workplace 


Java - Eclipse 
Hile Edit Navigate Search Project Bun Yindow Help 
in-HÀE:* 0-Q-:B-€G-:B2o/-:5n- veo »- BIg Jove } 
Ha Pec 53 \ fg Hie] = DI Bl Task List 23 WI 
Bie SACHER ZK Be 


POA P Activate... 


E Uncategorized 


BE Outline £3 Ld 
An outline is not available. 


Description 4 | Location! Type 


2.10 Eclipse 集成 开发 环境 


212 安装 Andad SDK 


Android SDK 是 Android 软件 开发 工具 包 (Android Software Development Kit) ,是 
Google 公司 为 了 提高 Android 应 用 程序 开发 效率 减少 开发 周期 而 提供 的 辅助 开发 工 
具 、 开 发 文档 和 程序 范例 。 

Android SDK 可 以 从 Google 的 中 文 Android 开发 网 站 上 下 载 ,网 站 的 地 址 是 
http://code. google. com/android。 开 发 网 站 不 仅 能 够 下 载 最 新 的 Android SDK, 还 有 
许多 有 价值 的 内 容 , 如 开发 文档 、 常 见 问题 解答 等 ,图 2. 11 是 中 文 Android 开发 网 站 的 
主页 面 。 

在 主页 面 上 点 击 “ 下 载 SDK” 超 链接 , 则 可 以 进入 最 新 版 本 的 Android SDK 下 载 页 
面 ,如 图 2. 12 所 示 。 根 据 操作 系统 不 同 ,选择 下 载 不 同 版 本 的 Android SDK 。 选 择 下 载 
Windows 版 本 的 Android SDK ,文件 名 为 android-sdk-windows-1. 5_r3. zip. 

Android SDK 下 载 完成 后 ,将 ZIP 压缩 包 中 的 目录 解压 到 硬盘 中 。 本 文 将 Android 
SDK 解压 到 E:\ Android\android-sdk-windows-1. 5_r3 目录 中 。Android SDK 不 需要 安 
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装 ,但 在 Eclipse 中 开发 Android 程序 前 ,要 把 Android SDK 与 Eclipse 开发 环境 关联 起 
来 ,具体 的 关联 方法 在 2. 1. 3 节 进 行 介绍 。 


ANDROID LL m 
Android - 一 个 开放 手机 联盟 项 目 主页 Sh SONNE WE rum ap 
fee n 30 EENS HE) 已 开发 出 Android. Android SETAE. AM. Sé 
DAMA RAMANA, BEP Android ARE 使 用 入 门 
1. T8 Android 
z SOK 
无 界限 的 应 用 程序 " we Hense vematrra S E eene 
Android 上 的 应 用 得 序 可 以 通过 标准 ap 2 ie 
SUBSE. ATR, Ggs GERE Lhe d 
可 以 声明 它们 的 功能 可 以 供 其 他 应 用 程序 使 beer dee 
Een 精 选 视频 
By 应 用 程序 可 以 轻松 地 嵌入 网 络 e Misc NN 


ze s 应 明 程 订 可 以 移 检 地址 入 HINL, Javascript a Android $R ESNY, HF 
样式 表 。 应 用 程序 可 以 通过 Web View S WE SE dër 
Bee FRA LIENS EE. eee 


2.11 #X Android 开发 网 站 的 主页 面 


Download Android 1.5 SDK, Release 3 


July 2009 


Before downloading, please read the System Requirements document. As you start the download, you will also need to 
review and agree to the Terms and Conditions that govern the use of the Android SDK. 


android-sdk-windows-1.5 I3.zip 191477853 bytes 1725fd6963ce69102ba7 192568dfc711 
Mac OS X (intel) android-sdk-mac x86-15 (3.zip 183024673 bytes bi bafdaefdcec89a14b604b504e7daec 
Linux(386) ^ android-sdk-linux x86-1.5 /3.zip 178117561 bytes 350d0211678ced38da926bBc9fia4fac 


For more information on this SDK release, read the Release Notes. 


2.12 Android SDK 下 载 页 面 


213 安装 ADT 插 件 


ADT 插件 是 Eclipse 集成 开发 环境 的 定制 插件 ,为 开发 Android 应 用 程序 提供 了 一 
个 强大 的 ,完整 的 开发 环境 ,可 以 快速 建立 Android 工程 ,用 户 界 面 和 基于 Android API 
的 组 件 ,还 可 以 使 用 Android SDK 提供 的 工具 进行 程序 调试 ,对 apk 文件 进行 签名 等 等 。 

一 般 情况 下 ,推荐 使 用 安装 ADT 插件 的 Eclipse 开发 Android 应 用 程序 ,因为 这 是 
最 为 便捷 、 快 速 的 开发 环境 。 在 Eclipse 和 Android SDK 正确 安装 后 ,就 可 以 下 载 并 安装 
ADT 插件 了 。 

安装 ADT 插件 有 两 种 方法 ,一 种 方法 是 手动 下 载 ADT 插件 的 压缩 包 , 然 后 在 
Eclipse 中 进行 安装 ; 另 一 种 方法 是 在 Eclipse 中 输入 插件 的 下 载 地 址 ,由 Eclipse 自动 完 
成 下 载 和 安装 工作 。 推 荐 使 用 第 一 种 方法 ,下 载 到 本 地 的 ADT 插件 压缩 包 可 以 再 次 使 
用 , 且 安 装 成 功 的 几率 很 高 。 下 面 对 两 种 安装 ADT 插件 的 方法 进行 介绍 。 

1) 方法 一 一 一 手动 下 载 ADT 插件 

手动 下 载 ADT 插件 压缩 包 的 网 址 是 http://dl-ssl. google. com/android/eclipse/. 
如 果 上 面 提供 的 网 页 无 法 打开 ,可 以 在 Android SDK 帮助 文档 中 找到 下 载 页 面 ,下 载 页 
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面 的 位 置 是 二 Android SDK >/docs/sdk/adt_download. html, 网 页 打开 后 的 ADT 插件 
的 下 载 页 面 如 图 2. 13 所 示 。 


Download the ADT Plugin Zip File 
If you are unable to download the ADT plugin through setting up a remote update site in Eclipse, you can download the ADT zip file and install it from your computer 
(archived site) instead 


If you use this approach, in order to update the plugin, you will need to download the latest version from this page, uninstall the old version from Eclipse, then install the new 
version, For more details on the procedure, see Troubleshooting ADT Installation in the installation page 


ADT-0.9.1.zip 2916093 bytes e7b2ab40414ac98 Required for users of Android 1.5 SDK (and later releases). Updated from 0.9.0. 6 May 2009 


08.0 ADT-0.8.0.zip Required for users of Android 1.1 SDK and Android 1.0 SDK 23 Sep 2008 


2.13 ”ADT 插件 的 下 载 页 面 


在 下 载 页 面 中 选择 下 载 ADT-0. 9. 1. zip 文件 ,下 载 过 程 仍 需要 访问 互联 网 ,实际 的 
下 载 地 址 为 http://dl-ssl. google. com/android/ ADT-0. 9. 1. zip。 

EFR ADT 插件 压缩 包 后 ,启动 Eclipse, 选 择 Help 一 Install New Software. 打开 
Eclipse 的 插件 安装 界面 ,如 图 2.14 所 示 。 


Install 


Available Software 


Select a site or enter the location of a site 


Work with: |type or select a site wm. 


Find more software by working with the ‘Available Software Sites’ preferences. 


type filter text 


Name 
EO There is no site selected. 


Details 
Show only the latest versions of available software []Hide items that are already installed 
What is slready installed? 


[r2 
[V]Group items by category 
[V]Contact all update sites during install to find required software 


® LE pss 


图 2.14 Eclipse 的 插件 安装 界面 


单 击 Add 按钮 ,弹出 Add Site 界面 ,如 图 2. 15 所 示 。 然 后 再 次 单 击 Archive 按钮 选 
择 ADT 插件 压缩 包 在 本 地 磁盘 中 的 保存 位 置 。 正 确 选 择 保存 位 置 后 ,ADT 插件 压缩 包 
的 保存 位 置 将 显示 在 Location 文本 框 中 。 

正确 选择 ADT 插件 压缩 包 的 保存 位 置 后 ,Eclipse 的 插件 安装 界面 会 出 现 ADT dd 
件 安装 选项 ,如 图 2. 16 所 示 。 选 中 Android DDMS 复 选 框 和 Android Development 
Tools 复 选 框 ,然后 单 击 Next 按钮 进入 ADT 插件 许可 界面 。 
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Add Site 


jar: file: /E:/Android/Androi dTools/ADT-0. 9. 1. zip!/ 


图 2.15 Add Site 界面 


Version 


(00 Developer Tools 
@ Android Doms 0.9. 1. v200805011822-1621 
@ Android Development Tools 0.9. 1. v200905011822-1621 


2.16 ADT 插件 安装 选项 


在 ADT 插件 安装 前 ,还 需要 认可 ADT 插件 所 使 用 的 许可 证 。ADT 插件 使 用 许可 
界面 如 图 2.17 所 示 ,选择 I accept the terms of the license agreements 单 选项 即 可 。 


Install 


Review Licenses 


Licenses must be reviewed before the software can be installed. This includes licenses 
for software required to complete the install. 


Items with licenses: License text: 


Pe Note: jcommon-1.0.12. jar is under the BSD license rather than 
ec the APL. You can find a copy of the BSD License at 
Léi Android DINS http://www. opensource. org/licenses/bsd-license. php 


Q Android Development Tools 

Bs mE jfreechart-1.0.9, jar and jfreechart-1.0.9-swt. jar are under 
Hylyn Bridge: Eclipse the LGPL rather than the EPL. You can find a copy of the LGPL at 
hylyn Bridge: Java Developnent|http: //wwv. gnu. org/licenses/old-licenses/lgpl-2.1. txt. You can 
P get the source code for these two components at 

Wis Bridge: Tean Support ` Vos: git kernel. org/pub/ jfreechart-1.0.9. zip 


G@ittylyn Connector: Bugzilla 
hylyn Task List (Required) 
Apache License 


@imyiyn Tesk-Focused Interface | Version 2.0, January 2004 
hylyn WikiText http://www. apache. org/licenses/ 


(1 accept the terms of the license agreements 
=) OT do not accept the terms of the license agreements 
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2.17 ADT 插件 使 用 许可 界面 


整个 安装 过 程 会 持续 几 分 钟 , 安 装 结束 后 会 出 现 Eclipse 重启 提示 界面 ,如 图 2. 18 
所 示 。 建 议 选择 Yes 按钮 重新 启动 Eclipse, 使 ADT 插件 生效 。 


Software Updates 


effect. For some add-ons, it may be possible to apply the changes you have 


v It is strongly recommended you restart Eclipse for the changes to take 
made without restarting. Would you like to restart now? 


Cos] Bo ‘Apply Changes 


图 2.18 Eclipse 重启 提示 界面 


2) 方法 二 一 一 自动 下 载 ADT 插件 
Eclipse 自动 下 载 ADT 插件 的 方法 与 手动 方法 安装 相似 ,不 同 之 处 在 于 不 需要 手工 
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到 网 站 上 下 载 ADT 插件 压缩 包 ,而 直接 在 Add Site 界面 中 输入 压缩 包 的 下 载 地 址 即 可 ， 
如 图 2. 19 所 示 。 


© Add Site 


https://dl-ssl. google. com/android/eclipse/ 


图 2.19 Add Site 界面 


在 Location 中 输入 https://dl-ssl. google. com/android/eclipse/. it OK 按钮 后 ， 
Eclipse 会 自动 搜索 可 安装 的 插件 。 在 网 络 连 通 的 状态 下 ,Eclipse 会 显示 如 图 2. 16 的 
ADT 插件 安装 选项 ,之 后 的 安装 过 程 与 手动 下 载 ADT 插件 ”的 方法 完全 一 致 。 

在 ADT 插件 安装 完毕 后 ,进入 配置 Android 开发 环境 的 最 后 一 步 : 设置 Android 
SDK 的 保存 路 径 。 首 先 选 择 Windows- Preferences 命令 打开 Eclipse 的 配置 界面 ,然后 
在 SDK Location 中 输入 Android SDK 的 保存 路 径 , 最 后 单 击 Apply 按钮 使 配置 生效 ,如 
图 2.20 所 示 。 


Preferences 


Android 

Android Preferences 

SDK Location; [E: \Android\androi d-sdk-windows-1.5_x3 ] [ Browse... 
Note: The list of SDK Targets below is only reloaded once you hit ‘Apply’ or OK’. 


Target Nane Vendor Platforn | AP... 
Android 1 1 Android Open Source Project mpm 2 


A 
Android 1.5 Android Open Source Project 1.5 3 
1.5 


Google APIs Google Inc 3 


Standard Android platform 1.1 


Seeler 
mm BER 


图 2.20 Eclipse 配置 界面 
至 此 ,Android 应 用 程序 的 开发 环境 就 安装 完成 了 ,后 续 的 内 容 将 对 Android SDK 
的 目录 结构 .示例 程序 和 开发 工具 进行 介绍 。 
22 Andad SK 
Android SDK 是 程序 开发 人 员 学 习 和 开发 Android 程序 的 宝贵 资源 ,不仅 提 供 了 开 
发 所 必 备 的 调试 .打包 和 仿真 工具 ,还 提供 了 详尽 的 说 明文 档 和 简单 易 懂 的 开发 示例 。 
221 目录 结构 


在 Android SDK 安装 到 本 地 磁盘 后 ,可 以 在 文件 系统 中 查看 到 Android SDK A A 
录 结 构 。Android SDK 的 目录 结构 如 下 所 示 : 
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(+ )add- ons 
(*)google apis- 3 
(~ ) README.txt 
(+ )docs 
(+ )platforms 
(+ )android- 1.1 
(+ )android- 1.5 
(+ ) tools 
(+ )usb_driver 
(+ )amd64 
(+ )x86 
(- )documentation.html 
(- )RELEASE NOTES.html 


其 中 ,add-one 目录 下 的 是 Google 提供 地 图 开发 的 库 函 数 , 支 持 基 于 Google Map 的 地 图 
FE. docs 目录 下 的 是 Android SDK 的 帮助 文档 ,通过 根 目录 下 的 documentation. html 
文件 启动 ,Android SDK 帮助 文档 的 首页 如 图 2. 21 所 示 。platforms 目录 中 存在 两 个 子 
目录 android-1. 1 和 android-1. 5, 分 别 用 来 保存 1. 1 版 本 和 1.5 版 本 的 Android SDK 的 
库 函 数 、 外 观 样 式 ,程序 示例 和 辅助 工具 等 内 容 。tools 目录 下 的 是 通用 的 Android 开发 
和 调试 工具 。usb_driver 目录 下 保存 了 用 于 amd64 和 x86 平台 的 USB( 通 用 串 行 总 线 ) 
驱动 程序 。RELEASE_NOTES. html 是 Android SDK 的 发 布 说 明 。 


developers TT 


SDK DevGuide | Reference Blog Community 


Welcome to the Android SDK! 


If youve just downloaded the SDK, then continue with Installing the Android SDK. 

If you're upgrading from a previously installed version, then refer to the Upgrading guide 

Once youve completed the SDK installation, you can start learning about development on the Android 

framework by reading the Developer's Guide. The SDK package also includes a wide variety of code 

samples specific to each Android platform, You can find the samples at this location: 
<sdk>/platforns/android~<version>/sanples/ 


Please note that you are currently viewing a local, offline version of the Android developer documentation 
The offline documentation offers the same content and features as the online documentation, but since 
the search capability is network-based, it will not work while you are offline. Autocompletion for API 
packages and classes, also offered from the search box, is available both online and offline and loads the 
reference documentation for the item you select. 


For the most current, fully searchable documentation, please visit 
http;//developer.android.com. 


Except as noted, this content is licensed under Creative Commons Attribution 2.5. For details and restrictions, see the Content License 
Site Terms of Service - Privacy Policy - Brand Guidelines 


图 2.21 Android SDK 帮助 文档 


Android SDK 帮助 文档 内 容 非 常 丰富 ,详细 介绍 了 Android 系统 中 所 有 API 函数 的 
使 用 方法 ,尤其 帮助 文档 中 的 开发 指南 (Dev Guide) ,系统 地 介绍 了 Android 应 用 程序 的 
开发 基础 .用 户 界面 .资源 使 用 .数据 存储 、 音 视频 功能 、 集 成 开发 环境 和 开发 工具 等 内 
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容 , 对 于 学 习 Android 程序 开发 具有 指导 意义 。 
222 示例 程序 


Æ< Android SDK>\platforms\android-1. 5\samples 目录 下 ,存放 了 针对 Android 
SDK 1. 5 版 本 的 多 个 示例 程序 。 这 些 示例 程序 多 数 并 不 复杂 ,但 可 以 从 不 同方 面 展示 
Android SDK 所 提供 的 丰富 功能 。 

1) HelloActivity 示例 

HelloActivity 是 最 简单 的 Android 程序 示例 。 虽 然 程序 简单 , 却 可 以 完整 展示 
Android 工程 的 文件 结构 和 调试 过 程 。 程 序 开发 人 员 可 以 参考 HelloActivity 示例 ,完成 
第 一 个 Android 应 用 程序 。HelloActivity 示例 如 图 2. 22 所 示 。 

2) ApiDemos 示例 

ApiDemos 示例 提供 了 Android 平台 上 多 数 API 的 使 用 方法 ,涉及 系统 .资源 .图形 、 
搜索 .语音 识别 和 用 户 界面 等 方面 。 程 序 开 发 人 员 可 以 在 Android 应 用 程序 开发 过 程 中 
参考 ApiDemos 示例 ,但 该 示例 的 代码 文件 众多 ,结构 略 显 混乱 ,给 参考 和 学 习 带 来 一 定 
的 不 便 。ApiDemos 示例 如 图 2. 23 所 示 。 


Hello, Activity! 


BME 1:16am 


One Shot Alarm 
Start Repeating Alarm 
Stop Repeating Alarm 


Content 


Graphics 


Hello, World] 


Media 


One-shot alarm will go off In 30 seconds 
based on the real time clock. Tr 
changing the current time before then! 


Æ 2.22 HelloActivity 示例 图 2.23 ApiDemos 示例 


3) SkeletonApp 示例 

SkeletonApp 示例 是 一 个 界面 演示 程序 ,说 明了 如 何 使 用 布局 和 界面 控件 设计 用 户 
界面 ,以 及 如 何在 界面 中 添加 菜单 和 处 理 菜单 事件 。SkeletonApp 示例 如 图 2. 24 所 示 。 

4) NotesList 示例 

NotesList 示例 是 一 个 记事 本 程序 ,可 以 将 文字 内 容 保 存在 记事 本 程序 中 ,并 支 
持 添加 和 删除 记事 本 操作 。NotesList 示例 说 明了 如 何 进行 复杂 程序 设计 ,以 及 如 何 
使 用 SQLite 数据 库 保 存 数 据 和 ContentProvider 共享 数据 。NotesList 示例 如 图 2. 25 
所 示 。 
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e BMS 1:41am 


Create note 


Skeleton App 


NotesList 
Line 1 


Hello there, you Activity! 


2.24 SkeletonApp 示例 2.25 NotesList 示例 


5) Home 示例 

Home 示例 是 一 个 桌面 主题 程序 ,可 以 将 自 定 义 的 桌面 主题 注册 到 系统 中 ,用 户 可 以 
通过 单 击 HOME 按钮 选择 不 同 的 桌面 主题 。 此 示例 说 明了 如 何 进 行 桌面 主题 程序 的 开 
发 ,以 及 在 开发 过 程 中 需要 注意 的 事项 。Home 示例 如 图 2.26 所 示 。 


© Complete action using 
7 Home 


aa Home Sample 


GBB ose by default for this action. 


2.26 Home 示例 


6) SoftKeyboard 示例 

SoftKeyboard 示例 是 一 个 软 键盘 程序 ,在 用 户 将 焦点 切换 到 输入 框 后 , 软 键盘 会 自 
动弹 出 ,用 户 可 以 使 用 软 键盘 进行 英文 文字 输入 。SoftKeyboard 示例 如 图 2. 27 所 示 。 

7) Snake 示例 

Snake 示例 是 贪 吃 蛇 程 序 , 一 个 经 典 的 小 游戏 ,可 以 通过 导航 键 控制 贪 吃 蛇 的 前 进 方 
向 。 该 示例 演示 了 如 何在 Android 系统 中 进行 游戏 开发 ,对 进行 游戏 开发 的 程序 人 员 具 
有 一 定 的 参考 价值 。Snake 示例 如 图 2. 28 所 示 。 
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qwieirit yuii o/p 
al (s1 fd] rfi rg: ri HO ERG PT 
$ zxcvibin m aq 


ci | pm m pov 


图 2.27 SoftKeyboard 示例 图 2.28 Snake 示例 


8) LunarLander 示例 

LunarLander 示例 也 是 一 个 小 游戏 ,模拟 登陆 舱 在 月 球 表面 着 陆 。 用 户 通 过 控制 登 
陆 舱 的 方向 和 速度 ,使 登陆 舱 可 以 平稳 地 在 月 球 表面 着 陆 。LunarLander 示例 实现 了 简 
单 的 碰撞 检查 功能 ,值得 游戏 开发 人 员 学 习 和 参考 。LunarLander 示例 如 图 2. 29 所 示 。 

9) JetBoy 示例 

JetBoy 示例 是 一 个 支持 背景 音乐 和 音效 的 游戏 程序 ,用 户 可 以 控制 飞船 击 碎 飞 来 的 
陨石 。JetBoy 示例 如 图 2. 30 Aras. 


图 2.29 SoftKeyboard 示例 图 2.30 JetBoy 示例 


223 开发 工具 


Android SDK 提供 了 多 个 强大 的 开发 工具 ,便于 程序 开发 人 员 简 化 开发 和 调试 过 
程 。 这 些 工具 中 多 数 可 以 在 Eclipse 中 直接 调用 ,但 也 有 部 分 工具 需要 在 命令 行 模式 下 
使 用 ,下 面 的 内 容 将 逐个 介绍 这 些 工具 。 
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1. Android 模拟 器 


Android SDK 中 最 重要 的 工具 就 是 Android 模拟 器 ,模拟 器 文件 的 位 置 是 
<Android SDK>/tools/emulator. exe。 正 是 因为 Android 模拟 器 的 存在 ,让 程序 开发 
人 员 在 没有 实际 设备 的 情况 ,可 以 对 Android 应 用 程序 进行 开发 .调试 和 仿真 。 

Android 模拟 器 还 支持 加 载 SD 卡 映 像 文件 ,更 改 模拟 网 络 状态 ,延迟 和 速度 ,模拟 
电话 呼叫 和 接收 短信 等 。 但 到 目前 为 止 ,Android 模拟 器 仍 有 大 量 不 支持 的 功能 ,包括 接 
听 真 实 电 话 呼叫 ,USB 连接 ,摄像头 捕获 ,设备 耳机 ,电池 电量 和 AC 电源 检测 ,SD 卡 插 
拔 检查 和 使 用 蓝牙 设备 等 。 

Android 模拟 器 还 支持 多 种 外 观 和 特性 ,包括 屏幕 的 尺寸 方向 等 ,可 以 参考 表 2. 1 。 


表 2.1 Android 模拟 器 外 观 


外 观 外 观 ID 说 明 
fit Br BE. 480 X320 
HVGA-L 方向 , Bus 
解析 度 : 320X480 
HVGA-P 方向 : 纵向 
缺 省 配置 
解析 度 : 320 X240 
uvm 方向 : 横向 
解析 度 : 240X320 
EUNT 方向 : 纵向 
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Android 模拟 器 支持 将 屏幕 当成 触摸 屏 使 用 ,可 以 使 用 鼠标 单 击 屏幕 模拟 用 户 对 
Android 设备 的 触摸 操纵 。 同 时 ,在 Android 模拟 器 上 有 普通 手机 设备 常见 的 各 种 按键 ， 
如 音量 键 . 挂 断 键 .返回 键 和 菜单 键 等 ,按键 的 布局 参见 图 2. 31。 


HOME 键 一 
呼出 /接听 键 


导航 键 
2.31 Android 模拟 器 按键 布局 


2. Android ij iX EF 


Android 调试 桥 (Android Debug Bridge,ADB) 是 用 于 连接 Android 设备 和 模拟 器 的 
工具 ,支持 应 用 程序 安装 .调试 和 传输 文件 。Android 调试 桥 是 一 个 客户 端 /服务 器 程序 ， 
号 含 守护 程序 .服务 器 程序 和 客户 端 程序 。 守 护 程序 运行 在 每 个 模拟 器 的 后 台 ; 服 务 器 
程序 运行 在 开发 环境 中 ,管理 客户 端 和 守护 程序 的 连接 ;客户 端 程序 通过 服务 器 程序 ,与 
模拟 器 中 的 守护 程序 相连 接 。 


3. DDMS 


DDMS(Dalvik Debug Monitor Service) 是 Android 系统 中 内 置 了 调试 工具 ,可 以 用 
来 监视 Android 系统 中 进程 .堆栈 信息 ,查看 logcat 日 志 , 实 现 端口 转发 服务 和 屏幕 截图 
功能 ,模拟 器 电话 呼叫 和 SMS 短信 ,以 及 浏览 Android 模拟 器 文件 系统 等 。DDMS 的 启 
动 文件 是 二 Android SDK> /tools/ddms. bat. 

在 Eclipse 中 , 选择 Windows > Open E 


Perspective DDMS 命令 ,打开 DDMS 调试 界 

面 ,然后 选择 Windows—Show view Other fi 

令 , 打 开 Show View 的 选择 对 话 框 ,如 图 2. 32 AE... 

所 示 。 这 样 就 可 以 在 DDMS 调试 界面 中 添加 人 

任何 希望 进行 调试 和 检查 的 功能 。 Se Etre . 
S ned 3 


DDMS 中 的 设备 管理 器 (Devices) ,可 以 同 
时 监控 多 个 Android 模拟 器 ,显示 每 个 模拟 器 
中 所 有 正在 运行 的 进程 。 模 拟 器 使 用 端口 号 进 


Use F2 to display the description for a selected view. 


me 


行 唯一 标识 ,例如 监听 端口 是 5554 的 模拟 器 则 图 2.32 Show View 选择 对 话 框 
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标识 为 emulator-5554。 在 选择 指定 的 进程 后 ,可 以 通过 右上 角 的 按钮 刷新 进程 中 线程 和 
堆栈 的 信息 ,或 是 单 击 STOP 按钮 关闭 指定 进程 。 另 外 ,还 提供 屏幕 截图 功能 ,可 以 将 
Android 模拟 器 当前 的 屏幕 内 容 保 存 成 png X ff. DDMS 中 的 设备 管理 器 如 
图 2.33 所 示 。 


DIE REM Bali: 


con. android. phone 


android. process. acore 
com. android. alarmclock 
android. process. media 
con. android. mms 


com. android. inputmethod. latin 


2.33 DDMS 中 的 设备 管理 器 


DDMS 中 的 模拟 器 控制 器 (Emulator Control) ,可 以 控制 Android 模拟 器 的 网 络 速 
度 和 延迟 ,模拟 语音 和 SMS 短信 通信 。 模 拟 器 控制 支持 的 网 络 速率 包括 GSM, HSCSD, 
PRS,EDGE,MTS,DPA 和 全 速率 ,支持 的 网 络 延 迟 有 GPRS, EDGE, UMTS 和 无 延迟 。 
DDMS 中 的 模拟 器 控制 器 如 图 2. 34 所 示 。 


Telephony Status -8 
Voice: | home E| Speed: |rul 国 
Data: [home 国 Latency: E 司 


p Telephony Actions 

| Incoming number: [13600001111 
O vice 
Za 


Message: Hello SWS ^ 


ed [Hang Up 
2.34 DDMS 中 的 模拟 器 控制 器 


在 Telephony Actions 中 的 Incoming number 文本 框 中 输入 呼叫 的 电话 号 码 , 然 后 
选择 语言 呼叫 (Voice) 单 选项 , 单 击 Send 按钮 后 ,模拟 器 就 可 以 接收 到 来 自 输入 电话 号 
码 的 语音 电话 ,如 图 2. 35 左 图 所 示 。 如 果 选 择 短信 (SMS) ,在 Message 中 填 入 短信 的 内 
容 , 模 拟 器 就 可 以 接收 到 来 自 输入 电话 号 码 的 SMS 短信 ,如 图 2. 35 右 图 所 示 。 

DDMS 中 的 文件 浏览 器 (File Explorer) ,可 以 对 Android 内 置 存储 器 上 的 文件 进行 
上 传 .、 下 载 和 删除 等 操作 ,还 可 以 显示 文件 和 目录 的 名 称 、 权 限 、 建 立时 间 等 信息 。DDMS 
中 的 文件 浏览 器 制 器 如 图 2. 36 所 示 。 

DDMS 中 的 日 志 浏 览 器 (LogCat) ,可 以 浏览 Android 系统 .Dalvik 虚拟 机 或 应 用 程 
序 产 生 的 日 志 信息 ,有 助 于 快速 定位 应 用 程序 产生 的 错误 。DDMS 中 的 日 志 浏 览 器 如 
图 2.37 所 示 。 
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[1] Bill G 7:37 AM 


1-360-000-1111 


1-360-000-1111 


E current call 


13600001111: Hello SMS 
Sent 7:39AM 


Type to compose 


Android 电话 呼叫 和 SMS 短信 


Size| Date | Time | Permiss... | Info | 

E E data 2009-06-20 00:53 drwxrwx--x 
E we 2009-06-20 00:54 drwxrwxrwx 
@ wp 2009-06-20 00:53 drwxrwx--x 
© spp-private 2008-06-20 00:53  drwxrwx-x 
@ dalvik-cach: 2009-06-20 00:53  drwxrwx-x 
@ data 2009-06-20 00:53 drwxrwx--x 
国 QR local 2009-06-20 00:53 drwxrwx--x 
国 @ losttfound 2009-06-20 00:53 drwxrwx--- 
@ wise 2009-06-20 00:53 drwxrwx--t 
@ property 2009-06-20 00:53 drwx------ 
@ system 2009-06-20 00:54  drwxrwxr-x 

8) © sdcard 2009-07-31 04:45 

@ system 2009-04-22 04:11 


DDMS 中 的 文件 浏览 器 


QOOOO +#- B= 


rSThread.run(AsyncPla 
ST mand pl 
TrackingPatternViev width=320 textureVidth=120 
TrackingPatternView width=320 textureVidth-120 
ActavityManager Starting activity: Intent ( action=android, intent act 
ActavityManager Displayed activity com android mns/ ui, ComposeMessage 
dalvikvn GC freed 5682 objects / 358168 bytes in i26ns 
GC freed 1086 objects ^ 48592 bytes in 104ns 


content ene, tbox, ma = 
ActivityManager Stopping service: com android mnas/.transaction ,SnsRec 转 | 


J 
D 
D 
I 
I 
D 
D 
D 

J 

J 
D 
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2.37 DDMS 中 的 日 志 浏览 器 


除了 上 面 介绍 的 功能 外 ,DDMS 还 能 够 查看 虚拟 机 的 堆栈 状态 .线程 信息 和 控制 台 
信息 。 由 此 可 见 ,DDMS 是 进程 程序 调试 和 错误 定位 的 强大 工具 。 


4. 其 他 工具 


为 了 便于 Android 程序 开发 ,Android SDK 还 提供 了 一 些小 工具 。 这 些 工 具 的 名 


称 、 用 途 和 启动 文件 如 表 2.2 所 示 。 
表 2.2 Android SDK 提供 的 其 他 工具 
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工具 名 称 启动 文件 说 HR 
数据 库 工 具 sqlite3. exe 用 来 创建 和 管理 SQLite 数据 库 
打包 工具 apkbuilder. bat 将 应 用 程序 打包 成 apk 文件 
层级 观察 器 hierarchyviewer. bat nl A 

- : 以 图 形 化 的 方式 显示 应 用 程序 的 执行 日 志 , 用 来 
跟踪 显示 工具 traceview. bat 调试 应 用 程序 ,分 析 执 行 效率 
SD 卡 映像 创建 工具 mksdcard. exe 建立 SD 卡 的 映像 文件 

NinePatch 是 Android 提供 的 可 伸缩 的 图 形 文件 

NinePatch 文件 编辑 工具 | draw9patch. bat 格式 ,基于 PNG 文件 。draw9patch 工具 可 以 使 


ST 


用 所 见 即 所 得 编辑 器 建立 NinePatch 文件 


题 


1, 尝试 安装 Android 开发 环境 ,并 记录 安装 和 配置 过 程 中 所 遇 到 的 问题 。 


2. 浏览 Android SDK 帮助 文档 ,了 解 Android SDK 帮助 文档 的 结构 和 用 途 ,这 样 会 


对 以 后 的 学 习 带 来 极 大 的 便利 。 


3. 在 Android SDK 中 ,Android 模拟 器 、Android 调试 桥 和 DDMS 是 Android 应 用 


程序 开发 过 程 中 经 常 使 用 到 的 3 个 工具 , 简 述 这 3 个 工具 的 用 途 。 


4. 为 了 进一步 熟悉 Android 模拟 器 ,通过 命令 行 方式 启动 模拟 器 ,并 在 模拟 器 中 学 
试 使 用 各 种 功能 和 应 用 软件 。 命 令 行 方 式 启动 模拟 器 的 方法 是 在 二 Android SDK>/ 


tools 目录 中 ,输入 命令 emulator-data test 即 可 。 


Android 应 用 程序 


本 章 主 要 介绍 了 开发 Android 应 用 程序 的 基础 知识 和 基本 方法 。 通 过 本 章 内 容 的 
学 习 , 读 者 可 以 完全 掌握 使 用 Eclipse 开发 Android 应 用 程序 的 过 程 和 方法 ,了 解 
Android 应 用 程序 的 目录 结构 和 自动 生成 文件 的 作用 。 学 习 使 用 命令 行 创 建 Android 应 
用 程序 ,有 助 于 深入 理解 Android 程序 的 生成 ,安装 和 运行 过 程 。 

本 章 学 习 目 标 : 

。 掌握 使 用 Eclipse 开发 Android 应 用 程序 的 方法 

。 掌握 Android 虚拟 设备 CAVD) 的 创建 方法 

。 TR. java 文件 的 用 途 和 生成 方法 

* 了 解 AndroidManifest. xml 文件 的 用 途 

* 了 解 Android 的 程序 结构 

。 了 解 使 用 命令 行 创建 Android 应 用 程序 方法 
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本 小 节 将 介绍 如 何 使 用 Eclipse 集成 开发 环境 建立 第 一 个 Android 程序 
HelloAndroid。 首 先 启 动 Eclipse, 显示 Eclipse 集成 开发 环境 如 图 3. 1 所 示 。 如 果 在 
Eclipse 中 建立 过 Android 工程 ,工程 名 称 和 目录 结构 将 显示 在 Package Explorer 区 
域内 。 

有 两 种 方法 可 以 打开 Android 工程 向 导 , 一 种 是 以 选择 File New Project: | 
Android Android Project 的 顺序 ; 另 一 种 是 以 选择 File New 一 Other*… | Android 
Android Project 的 顺序 。 两 种 方法 只 是 选择 的 顺序 不 同 , 结 果 是 相同 的 ,都 可 以 打开 
Android 工程 向 导 , 如 图 3. 2 所 示 。 在 第 二 种 方法 中 ,除了 可 以 建立 Android 工程 向 导 
外 ,还 可 以 建立 Android XML 文件 ,用 于 建立 用 户 界面 或 存储 数值 等 用 途 。 

在 Android 工程 向 导 中 ,需要 确定 工程 名 称 \ 保 存 位 置 .SDK 版 本 、 应 用 程序 名 称 、 包 
名 称 和 SDK 最 低 版 本 等 信息 ,后 续 内 容 将 对 每 一 项 进行 详细 介绍 。 第 一 步 需 要 填 人 工 
程 名 称 (Project Name) ,工程 名 称 必须 唯一 ,不 能 与 已 有 工程 重 名 , 填 人 HelloAndroid 作 
为 工程 名 称 。 


Android Project 


New Android Project 


Creates a new Android Project resource. 


Android Open Source Pro: 
Android Open Source Project 


图 3.2 Android 工程 向 导 
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第 二 步 是 在 Contents 中 选择 Android 工程 的 创建 方式 ,默认 是 在 工作 空间 中 创建 新 
Android 工程 ,也 可 以 选择 利用 已 有 代码 创建 Android 工程 ,读者 可 以 不 做 任何 更 改 , 保 
持 默 认 设置 。 当 然 , 也 可 以 取消 选中 Use default location 复 选 框 ,选择 其 他 位 置 保存 
Android 工程 。 作 者 的 Eclipse 工作 空间 是 下 :/Android/workplace, 因 此 HelloAndroid 
工程 的 保存 位 置 在 E:/Android/workplace/ HelloAndroid。 

第 三 步 是 在 Build Target 中 选择 编译 目标 , 即 Android 程序 所 运行 的 Android 系统 
版 本 和 是 否 支 持 附 加 库 。 其 中 有 三 个 复 选 框 ,第 一 个 是 标准 的 1. 1 版 本 Android 系统 ， 
API 等 级 为 2; 第 二 个 是 标准 的 1.5 版 本 Android 系统 ,API 等 级 为 3; 第 三 个 是 包含 
Google API 的 1.5 版 本 Android 系统 ,API 等 级 为 3。 选 择 Android 程序 的 编译 日 标 , 应 
该 根据 目标 手机 所 支持 的 Android 系统 版 本 所 定 。 选 择 不 同 版 本 的 Android 系统 ,在 工 
程 中 将 引入 不 同 版 本 的 android. jar 包 ; 选 择 支 持 Google API 的 Android 系统 ,将 引入 支 
FF Google 地 图 功能 的 maps. jar 包 。 选 择 第 二 个 复 选 框 ,标准 的 1.5 版 本 Android 系统 。 

第 四 步 是 在 Properties 中 填 入 相关 信息 。 应 用 程序 名 称 (Application Name) 是 
Android 程序 在 手机 中 显示 的 名 称 ,程序 运行 时 也 会 显示 在 手机 的 顶部 。 给 第 一 个 
Android 程序 起 一 个 英文 名 称 HelloAndroid, 当然 也 可 以 起 中 文 的 应 用 程序 名 称 ,例如 
“第 一 个 Android 程序 ”等 。 

包 名 称 (Package Name) 是 包 的 命名 空间 ,需要 遵循 Java 包 的 命名 方法 。 包 名 称 由 
两 个 或 多 个 标识 符 组 成 ,中 间 用 点 隔 开 ,例如 hrbeu. HelloAndroid。 使 用 包 主 要 为 了 避 
免 命 名 冲突 ,因此 可 以 使 用 反 写 电子 邮件 地 址 的 方式 保证 命名 的 唯一 性 ,例如 笔者 的 电 
子 邮件 地 址 是 wangxianghui (9 hrbeu. edu. cn, 则 可 以 将 包 名 称 命名 为 cn. edu. hrbeu. 
wangxianghui。 为 了 保证 代码 的 简洁 ,第 一 个 Android 程序 的 包 名 称 使 用 edu. hrbeu. 
HelloAndroid, 

创建 Activity( Create Activity) 是 一 个 可 选项 ,如 果 需 要 自动 生成 一 个 Activity 的 代 
码 文件 , 则 需要 选择 该 复 选 框 ,否则 可 以 不 选 。Create Activity 主要 用 于 管理 用 户 界 面 ， 
后 续 章 节 将 做 详细 介绍 ,选择 该 复 选 框 并 将 Create Activity 的 名 称 定 为 HelloAndroid。 
Create Activity 的 名 称 完全 可 以 与 应 用 程序 名 称 不 同 , 但 一 般 为 了 简洁 明了 ,会 使 这 个 
Create Activity 的 名 称 与 应 用 程序 的 名 称 相 同 , 表 示 这 个 Create Activity 是 Android 程 
序 运行 时 首先 显示 给 用 户 的 界面 。 

SDK 最 低 版 本 (Min SDK Version) 指 的 是 Android 程序 能 够 运行 的 最 低 的 API 等 
级 ,如 果 手 机 中 的 Android 系统 的 API 等 级 低 于 程序 的 SDK 最 低 版 本 , 则 程序 不 能 在 该 
Android 系统 中 运行 。 在 选择 Build Target 时 ,SDK 最 低 版 本 已 被 自动 十 人 3, 此 项 无 需 
更 改 。 

最 后 单 击 Finish 按钮 ,工程 向 导 会 根据 用 户 所 填写 的 Android 工程 信息 ,自动 在 后 
台 创 建 Android 工程 所 需要 的 基础 文件 和 目录 结构 。 当 创建 过 程 结束 ,用 户 将 看 到 
图 3.3 所 显示 的 内 容 。 

用 户 无 需 在 HelloAndroid 工程 中 添加 任何 代码 , 即 可 运行 HelloAndroid 程序 。 但 
为 了 让 Android 程序 能 够 正常 运行 ,必须 首先 建立 Android 虚拟 设备 (Android Virtual 
Device,AVD)。AVD 是 对 Android 模拟 器 进行 自 定 义 的 配置 清单 ,能 够 配置 Android 


2s Anod JL FR 43. FP 33 


模拟 器 的 硬件 列表 、 外 观 、.Android 版 本 、SDK 库 和 存储 配置 等 信息 。 因 为 在 1.5 版 本 的 
Android SDK 中 没有 附带 任何 配置 好 的 AVD, 因 此 即使 是 最 简单 的 HelloAndroid 程序 ， 
也 需要 建立 一 个 AVD,AVD 选择 标准 的 1.5 版 本 Android 系统 。 


Eoun SE 
Rate tla” 


E edu ken HelLeAndroi | 


« >o (pum a) 
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3.3 HelloAndroid 工程 的 基础 文件 和 目录 结构 


建立 AVD 需要 使 用 Windows 系统 的 命令 行 工 具 CMD, 选择 “开始 ”一 “运行 "一 
CMD 命令 ,启动 命令 行 工 具 , 并 进入 二 Android SDK>/tools 目录 下 ,其 中 所 Android 
SDK- X Android SDK 所 在 的 目录 ,本 书 的 Android SDK 安装 在 E: V Android \ 
android-sdk-windows-1.5_rl。 

为 了 选择 适合 的 编译 目标 ,需要 利用 android list targets 命令 搜索 二 Android 
SDK>/platforms 和 二 Android SDK>/add-ons 目录 下 所 有 有 效 的 Android 系统 映像 ， 
并 将 Android 系统 映像 列表 显示 在 命令 行 工 具 中 ,如 图 3.4 所 示 。 共 有 3 个 可 以 选择 的 
编译 目标 ,分别 是 1. 1 版 本 Android 系统 1. 5 版 本 Android 系统 和 包含 Google API 的 
1.5 版 本 Android 系统 。 其 中 前 两 个 系统 映像 的 Type 属性 是 Platform, 因 此 是 标准 的 
Android 系统 ,使 用 者 可 自行 配置 模拟 器 的 硬件 清单 ;最 后 一 个 系统 映像 的 Type 属性 是 
Add-On, 是 一 种 定制 系统 ,这 种 定制 系统 不 能 更 改 模拟 器 的 硬件 配置 清单 。 

使 用 android create avd -n androidl. 5 -t 2 命令 ,以 id 为 2 的 1.5 版 本 Android 系统 
为 目标 ,建立 一 个 名 为 Android1. 5 的 AVD。 其 中 ,-n 参数 表明 AVD 的 名 称 ,-t BRR 
明 选 择 的 Android 系统 映像 的 id 值 。 命 名 运行 时 会 询问 用 户 是 否 需 要 定制 硬件 配置 
清单 (Do you wish to create a custom hardware profile) ,选择 no, 使 用 默认 的 硬件 配置 ， 
运行 结果 如 图 3.5 所 示 。 当 然 也 可 以 选择 yes, 根 据 需要 重新 定制 模拟 器 支持 的 硬件 
清单 。 
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图 3.5 #32 AVD 


建立 AVD 过 程 中 , Android 工具 会 在 文件 系统 中 建立 Androidl. 5. ini 文件 和 
Androidl. 5. avd H 3t, Androidl. 5. ini 文件 用 来 保存 Android). 5. avd 目录 所 在 的 位 
置 ;Androidl. 5. avd 目录 则 用 以 保存 AVD 配置 文件 .用 户 数据 文件 .SD 卡 映 像 和 其 他 
模拟 器 运行 过 程 中 可 能 产生 文件 。Androidl. 5. ini 文件 和 Androidl. 5. avd 目录 的 保存 
位 置 ,会 根据 用 户 使 用 的 操作 系统 不 同 而 不 同 ,如果 用 户 使 用 的 是 Windows XP 系统 , 则 
目录 会 保存 在 C:\Documents and Settings\< user V. android\ 下 ;如 果 用 户 使 用 的 是 
Windows Vista 系统 , 则 目录 则 会 保存 在 C:\Users\<user>\. android F, AVD 的 管理 
命令 和 虚拟 硬件 列表 可 以 参考 附录 A。 

HelloAndroid 程序 正式 运行 前 ,还 需要 选择 Run— Run Configuration 命令 或 选择 
Run--Debug Configuration 命令 ,配置 模拟 器 的 启动 选项 。 图 3. 6 是 Run Configuration 
的 启动 选项 ,可 以 选择 不 同 的 AVD ,配置 网 络 速度 .网 络 延迟 .控制 台 的 字符 编码 和 标准 
输入 输出 等 内 容 。 一 般 情况 下 ,只 要 正确 选择 AVD 即 可 ,其 他 选项 可 以 不 做 任何 修改 。 

使 用 Eclipse 运行 Android 程序 非常 简单 ,只 要 选择 Run — Run | Android 
Application 命令 或 选择 Run 一 Debug| Android Application 命令 便 可 以 启动 模拟 器 ,并 运 
ff Android 程序 。 启 动 Android 模拟 器 是 一 个 缓慢 的 过 程 ,程序 调试 完毕 后 ,不 必 关 闭 
Android 模拟 器 ,再 次 运行 Android 程序 时 ,可 以 节约 启动 模拟 器 的 时 间 。Eclipse 会 自 
动 完 成 Android 程序 编译 `. 打 包 和 上 传 等 过 程 , 并 将 程序 的 运行 结果 显示 在 模拟 器 中 。 


HelloAndroid 程序 的 运行 结果 如 图 3.7 AAR 
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图 3.7 HelloAndroid 的 运行 结果 


目前 ,已 经 完成 了 第 一 个 Android 程序 ,并 得 到 了 程序 的 运行 结果 ,对 如 何 建立 和 运 
fT Android 程序 已 经 有 了 基本 的 了 解 。3. 2 节 仍 然 以 HelloAndroid 为 例 ,介绍 Android 
的 程序 目录 结构 和 文件 用 途 。 


32 Andad 程 序 结构 
在 建立 HelloAndroid 程序 的 过 程 中 , ADT 插件 会 自动 建立 一 些 目录 和 文件 ,如 


图 3. 8 所 示 。 这 些 目 录 和 文件 有 其 固定 的 作用 ,有 的 允许 修改 ,有 的 则 不 能 进行 修改 ,了 
解 这 些 文件 和 目录 ,对 Android 程序 开发 有 着 非常 重要 的 作用 。 
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在 Package Explore 中 ,ADT 以 工程 名 称 HelloAndroid 作为 根 目 录 , 将 所 有 自动 生 
成 的 和 非 自动 生成 的 文件 都 保存 在 这 个 根 目 录 下 。 根 目录 下 包含 4 个 子 目录 sre, 
assets,res 和 gen, 一 个 库 文件 android. jar, 以 及 两 个 工程 文件 Androidmanifest. xml 和 
default. properties, 

src 目录 是 源 代码 目录 ,所 有 人 允许 用 户 修改 的 Java 文件 和 用 户 自 己 添加 的 Java 文件 
都 保存 在 这 个 目录 中 。HelloAndroid 工程 建立 初期 ,ADT 根据 用 户 在 工程 向 导 中 的 
Create Activity 选项 ,自动 建立 HelloAndroid. 


[8 Package Explore 53 N fg Hierarchy] — O 
ags” java 文件 。 
a dm assets 目录 用 来 存放 原始 格式 的 文件 ,例如 音 
"Macc 频 文 件 、 视 频 文件 等 二 进 制 格式 文件 。 此 目录 中 
EE 的 资源 不 能 够 被 R. java 文件 索引 ,因此 只 能 以 字 
RECHT 节 流 的 形式 进行 读 取 。 一 般 情况 下 为 空 。 
iba om res 目录 是 资源 目录 ,Android 程序 所 有 的 图 
i 像 .颜色 .风格 .主题 .界面 布局 和 字符 串 等 资源 都 
iem 保存 在 其 下 的 三 个 子 目录 中 。 其 中 ,drawable H 
| 录用 来 保存 图 像 文 件 ,layout 目录 用 来 保存 与 用 
Ee i 户 界面 相关 的 布局 文件 , values 目录 保存 颜色 、 风 
Bren 格 .主题 和 字符 串 等 资源 。 在 HelloAndroid 工程 


3.8 HelloAndroid 工程 的 目录 和 文件 中 ,ADT 在 drawable 目录 中 自动 引入 了 icon. png 
文件 ,作为 HelloAndroid 程序 的 图 标 文件 ;在 
layout 目录 生成 了 mail. xml 文件 ,用 以 描述 图 3.7 所 显示 的 用 户 界面 ;在 values 目录 生 
成 了 strings. xml 文件 ,将 应 用 程序 名 称 "HelloAndroid” 和 界面 显示 的 “Hello World. 
HelloAndroid!1” 保 存在 这 个 文件 中 。 
gen 目录 是 1.5 版 本 新 增 的 目录 ,用 来 保存 ADT 自动 生成 的 Java 文件 ,例如 R. java 
或 AIDL 文件 。 
android. jar 文件 是 Android 程序 所 能 引用 的 函数 库 文件 ,Android 通用 平台 所 支持 
API 都 包含 在 这 个 文件 中 ,具体 内 容 参 考 附录 B。 
default. properties 文件 记录 了 Android 工程 的 相关 设置 ,例如 编译 目标 和 apk 设置 
等 ,该 文件 不 能 手工 修改 ,如 果 需 要 更 改 其 中 的 设置 ,必须 通过 右键 单 击 工程 名 称 , 在 弹出 
的 快捷 菜单 中 选择 Properties 选项 修改 。 从 default. properties 文件 的 代码 中 可 以 发 现 ,大 部 
分 都 是 内 容 注释 , 仅 有 第 12 行 是 有 效 代码 ,说 明了 Android 程序 的 编译 目标 。 
default. properties 文件 的 代码 如 下 : 


1 # This file is autamatically generated by Android Tools. 
2 # Do not modify this file- ~ YOUR CHANGES WILL BE ERASED! 
3 + 

4 # This file must be checked in Version Control Systems. 
5 + 

6 


# To custamize properties used by the Ant build system use, 
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7 # "build.properties", and override values to adapt the script to your 
8 # project structure. 


11 #Project target. 
12 target= android- 3 


AndroidManifest. xml 是 XML 格式 的 Android 程序 声明 文件 ,包含 了 Android 系统 
运行 Android 程序 前 所 必须 掌握 的 重要 信息 ,这 些 信息 包括 应 用 程序 名 称 、 图 标 、 包 名 
称 、 模 块 组 成 .授权 和 SDK 最 低 版 本 等 ,而 且 每 个 Android 程序 必须 在 根 目录 下 包含 一 
个 AndroidManifest. xml 文件 。AndroidManifest 文件 的 具体 内 容 可 以 参考 附录 D. 

XML 是 一 种 可 扩展 标记 语言 ,本 身 独 立 于 任何 编程 语言 ,能 够 对 复杂 的 数据 进行 编 
码 , 且 易 于 理解 。Android 工程 中 多 处 使 用 了 XML 文件 ,使 应 用 程序 开发 更 加 具有 弹 
性 , 且 易 于 后 期 的 维护 和 理解 。 

AndroidManifest. xml 文件 的 代码 如 下 : 


1 <?xml version= "1.0"encoding= "utf- 8"?» 

2 «manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 
3 package- "edu.hrbeu.Hel lohndroid"' 

4 android:versionCode- "1" 

5 android:versionName- "1.0" 

6 < application android:icon- "@ drawable/icon" 

7 android:label- "@ string/app name"> 

8 < activity android:name- ".HelloAndroid" 

9 android:label- "@ string/app name" 

10 « intent- filter> 

1 < action android:name- "android.intent.action.MAIN"/» 
12 < category android:name- "android.intent.category.LAUNCHER"/» 
13 < /intent- filter» 

14 < /activity» 


15 < /application» 

16 —— «uses- sdk android:minsdkVersion= "3"/> 

17  «/maifest^ 

在 AndroidManifest. xml 文件 中 , 根 元 素 是 manifest. 包含 了 xmlns: android, 
package, android: versionCode 和 android: versionName 等 4 个 属性 。xmlns:android 定 
MT Android 的 命名 空间 , 值 为 http://schemas. android. com/apk/res/android; package 
定义 了 应 用 程序 的 包 名 称 ;android: versionCode 定义 了 应 用 程序 的 版 本 号 ,是 一 个 整数 
值 ,数值 越 大 说 明 版 本 越 新 ,但 仅 在 程序 内 部 使 用 ,并 不 提供 给 应 用 程序 的 使 用 者 ; 
android: versionName 定义 了 应 用 程序 的 版 本 名 称 , 是 一 个 字符 串 , 仅 限于 为 用 户 提 供 一 
个 版 本 标识 。 

manifest 元 素 仅 能 包含 一 个 application 元 素 ,application 元 素 中 能 够 声明 Android 
程序 中 最 重要 的 4 个 组 成 部 分 .包括 Activity、Service、BroadcastReceiver 和 
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ContentProvider, 所 定义 的 属性 将 影响 所 有 组 成 部 分 。 第 6 行 属 性 android:icon 定义 了 
Android 应 用 程序 的 图 标 , 其 中 @drawable/icon 是 一 种 资源 引用 方式 ,表示 资源 类 型 是 
图 像 ,资源 名 称 为 icon, 对 应 的 资源 文件 为 res/drawable 目录 下 的 icon. png; 第 7 行 属性 
android:label 则 定义 了 Android 应 用 程序 的 标签 名 称 。 

activity 元 素 是 对 Activity 子 类 的 声明 ,不 在 AndroidManifest, xml 文件 中 声明 的 
Activity 将 不 能 在 用 户 界面 中 显示 。 第 8 行 属性 android: name 定义 了 实现 Activity 类 的 名 
称 , 可 以 是 完整 的 类 名 称 , 如 edu. hrbeu. HelloAndroid, 也 可 以 是 简化 后 的 类 名 称 , 如 

. HelloAndroid; 第 9 行 属性 android: label 则 定义 了 Activity 的 标签 名 称 ,标签 名 称 将 在 用 户 

界面 的 Activity 上 部 显示 ,@string/app_name 同样 属于 资源 引用 ,表示 资源 类 型 是 字符 串 ， 
资源 名 称 为 app_name, 资 源 保存 在 res/values 目录 下 的 strings. xml 文件 中 。 

intent-filter 中 声明 了 两 个 子 元 素 action 和 category, 在 这 里 不 详细 讨论 两 个 子 元 素 
的 用 途 , 但 可 以 肯定 的 是 ,intent-filter 使 HelloAndroid 程序 在 启动 时 ,将 . HelloAndroid 
这 个 Activity 作为 默认 启动 模块 。 

DT 包含 了 一 个 可 视 化 的 编辑 器 ,如 图 3. 9 所 示 , 双 击 AndroidManifest. xml 文件 可 
直接 进入 可 视 化 编辑 器 。 用 户 可 以 在 不 接触 XML 的 情况 下 ,编辑 Android 工程 的 应 用 
程序 名 称 、 包 名 称 、 图 标 、 标 签 和 许可 等 相关 属性 。 
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913.9 HelloAndroid 工程 的 目录 和 文件 


AR. java 文件 是 ADT 自动 生成 的 文件 ,包含 对 drawable, layout 和 values 目录 内 的 资源 
的 引用 指针 ,Android 程序 能 够 直接 通过 R 类 引用 目录 中 的 资源 。R. java 文件 不 能 手工 修 
改 , 所 有 代码 必须 由 ADT 自动 生成 。 如 果 向 资源 目录 中 增加 或 删除 了 资源 文件 , 则 需要 在 
工程 名 称 上 右 击 ,在 弹出 的 快捷 菜单 中 选择 Refresh 选项 来 更 新 R. java 文件 中 的 代码 。 
HelloAndroid 工程 生成 的 R. java 文件 的 代码 如 下 : 


1 package edu.hrbeu.HelloAndroid; 
2 
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public final class R ( 
public static final class attr { 
} 
public static final class drawable { 
public static final int icon- 0x7£020000; 
) 
public static final class layout ( 
public static final int main- 0x7£030000; 


wo OI DO B® QU 


} 
public static final class string { 
public static final int app name- 0x7f040001; 
public static final int hello 0x7£040000; 
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} 


R 类 包含 的 几 个 内 部 类 ,分 别 与 资源 类 型 相对 应 ,资源 ID 便 保 存在 这 些 内 部 类 中 ， 
例如 子 类 drawable 表示 图 像 资源 ,内 部 的 静态 变量 icon 表示 资源 名 称 ,其 资源 ID 为 
0x7f020000。 一 般 情况 下 ,资源 名 称 与 资源 文件 名 相同 (不 包含 扩展 名 ) ,如 icon 对 应 
src/drawable 目录 下 的 icon. png 文件 ,main 对 应 src/layout 目录 下 的 main. xml 文件 。 

资源 的 引用 一 般 有 两 种 情况 ,一 种 是 在 代码 中 引用 资源 , 另 一 种 则 是 在 资源 中 引用 

在 代码 中 引用 资源 时 ,需要 在 代码 中 使 用 资源 ID, 可 以 通过 [R. resource_type. 
resource. name ] 3; # [ andrlid. R. resource. type. resource__name] 获 取 资 源 ID。 其 中 ， 
resource type 代表 资源 类 型 ,也 就 是 R 类 中 的 内 部 类 名 称 ;resource_name 代表 资源 名 
称 , 对 应 资源 的 文件 名 (不 包含 扩展 名 ) 或 在 XML 文件 中 定义 的 资源 名 称 属性 。 例 如 在 
HelloAndroid. java 中 ,第 11 行 代码 便 是 在 代码 中 对 资源 的 引用 。 

在 资源 中 引用 资源 时 ,一 般 的 引用 格式 为 @[package: jtype:name。 其 中 ,@ 表 示 对 
资源 的 引用 ;package 是 包 名 ,如 果 在 相同 的 包 内 ,package 则 可 省 略 ;type 是 资源 的 类 型 ， 
例如 string 或 drawable;name 是 资源 的 名 称 。 例 如 在 main. xml 文件 中 ,第 10 行 代码 就 
是 在 资源 中 对 资源 的 引用 。 

main. xml 文件 的 代码 如 下 : 


<?xml versione "1.0"encoding= "utf- 8"?» 
< Linearlayout xmlns:android- "http: //schemas .android.can/apk/res/android" 
android:orientation- "vertical" 
android: layout_width= "fill parent" 
android: layout_height= "fill parent" 
> 
< TextView 
android: layout_width= "fill parent" 
android: layout height= "wrap content" 
android:text- "@ string/hello" 
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11 /> 

12 < /LinearLayout> 

main. xml 文件 是 界面 布局 文件 ,利用 XML 语言 描述 的 用 户 界面 ,界面 布局 的 相关 
内 容 将 在 第 5 章 用 户 界面 设计 中 进行 详细 介绍 。main. xml 代码 的 第 7 行 说 明 在 界面 中 
使 用 TextView 控件 , TextView 控件 主要 用 来 显示 字符 串 文本 。 代 码 第 10 行 说 明 
Text View 控件 需要 显示 的 字符 串 , 非 常 明显 ,@ string/hello 是 对 资源 的 引用 。 通 过 
strings. xml 文件 的 第 3 行 代码 分 析 , 在 TextView 控件 中 显示 的 字符 串 应 是 “Hello 
World，HelloAndroid!”。 如 果 读 者 修改 strings. xml 文件 的 第 3 行 代码 的 内 容 , 重 新 编 
WE .运行 后 ,模拟 器 中 显示 的 结果 也 应 该 随 之 更 改 。 

strings. xml 文件 的 代码 如 下 : 


1 <?xml versia "1.0"encoding= "utf- 8"?» 

2 < resources> 

3 < string name= "hello"> Hello World, HelloAndroid!« /string» 

4 < string name- "app name"» HelloAndroick /string» 

5 < /resources» 

HelloAndroid. java 是 Android 工程 向 导 根 据 Activity 名 称 创建 的 Java 文件 ,这 个 
文件 完全 可 以 手工 修改 。 为 了 在 Android 系统 上 显示 图 形 界 面 , 需 要 使 用 代码 继承 
Activity 类 ,并 在 onCreateO 函数 中 声明 需要 显示 的 内 容 。 

HelloAndroid. java 文件 的 代码 如 下 : 


1 package edu.hrbeu.HelloAndroid; 

2 

3 import android.app.Activity; 

4 import android.os.Bundle; 

5 

6 public class HelloAndroid extends Activity { 

7 / ** Called when the activity is first created. * / 
8 @ Override 

9 public void onCreate (Bundle savedInstanceState) { 
10 super .onCreate (savedInstanceState) ; 

n setContentView (R. layout .main) ; 

12 } 

13 } 


代码 的 第 3 行 和 第 4 行 , 通 过 android. jar 从 Android SDK 中 引入 了 Activity 和 
Bundle 两 个 重要 的 包 , 用 于 子 类 继承 和 信息 传递 ;第 6 行 声 明 HelloAndroid 类 继承 
Activity 类 ;第 8 行 表明 需要 重 写 onCreateO RAAG 9 行 的 onCreate() 会 在 Activity 首 
次 启动 时 会 被 调用 ,为 了 便于 理解 ,可 以 认为 onCreate() 是 HelloAndroid 程序 的 主人 
函数 ;第 10 行 调用 父 类 的 onCreate ( ) PR Zt. FF HF savedInstanceState 传递 给 父 类 ， 
savedInstanceState 是 Activity 的 状态 信息 ;第 11 行 声明 了 需要 显示 的 用 户 界 面 ,此 界面 
是 用 XML 语言 描述 的 界面 布局 ,保存 在 scr/ layout/main. xml 资源 文件 中 。 
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在 分 析 了 Android 程序 的 目录 结构 和 文件 的 用 途 后 ,对 AndroidManifest. xml X fF, 
Java 代码 文件 .资源 引用 和 R. java 等 内 容 有 了 初步 的 了 解 ,3. 3 节 将 着 重 介绍 如 何 使 用 
命令 行 工具 创建 Android 程序 ,有 助 于 深入 理解 Android 程序 的 生成 ,安装 和 运行 过 程 。 


3 使 用 命令 行 工具 创建 程序 


到 目前 为 止 ,读者 应 该 非常 熟悉 如 何 使 用 Eclipse 建立 小 型 Android 应 用 程序 ， 
Eclipse 能 够 为 使 用 者 提供 良好 的 编辑 和 调试 环境 ,并 能 够 自动 完成 程序 的 编译 、apk dT 
包 和 上 传 安装 等 过 程 。 但 Eclipse Jf AE Android 程序 的 唯一 开发 环境 ,IntelliJ IDEA 
和 文本 编辑 器 同样 也 能 够 完成 Android 程序 开发 。Android SDK 中 包含 了 所 有 Android 
程序 开发 过 程 中 所 需要 的 编译 .调试 .打包 和 上 传 工具 ,能 够 在 非 Eclipse 环境 下 帮助 用 
户 完成 Android 程序 开发 。 本 节 将 尝试 使 用 文本 编辑 器 和 命令 行 工 具 创 建 Android fe 
Ff. HelloCommondline, 如 果 读 者 对 使 用 命令 行 工具 开发 Android 程序 并 不 感 兴趣 , 完 
可 以 跳 过 本 节 。 

Android 命令 行 工 具 都 保存 在 二 Android SDK >/tools 目录 下 ,这 些 命令 行 工 具 在 
Android SDK 起 着 非常 重要 的 作用 ,因为 即使 用 户 使 用 Eclipse 开发 Android 程序 ,很 多 重要 
的 功能 也 都 是 调用 Android 命令 行 工具 完成 的 ,例如 建立 工程 在 模拟 中 运行 程序 等 。 

使 用 命令 行 工 具 开 发 Android 程序 一 般 分 为 如 下 几 个 步骤 : 

(1) 使 用 android. bat 建立 HelloCommondline 工程 所 需 的 目录 和 文件 。 

(2) 使 用 Apache Ant 对 HelloCommondline 工程 进行 编译 和 apk 打包 。 

(3) 使 用 adb. exe 将 HelloCommondline 工程 上 传 到 Android 模拟 器 中 。 

第 一 步 , 使 用 android. bat 建立 HelloCommondline 工程 所 需 的 目录 和 文件 。 
android. bat 是 一 个 批 处 理 文 件 , 可 以 用 来 建立 和 更 新 Android 工程 ,同时 也 可 以 管理 
AVD. android. bat 能 够 创建 Android 工程 所 需要 的 目录 结构 和 文件 , 表 3.1 给 出 了 
android. bat 建立 和 更 新 Android 工程 的 命令 和 参数 说 明 。 


表 3.1 Android 工程 管理 命令 


命 * 参 数 说 明 备 注 
-k<package> 包 名 称 必 备 参数 
-n<name> 工程 名 称 
android create project -a<activity> Activity 名 称 
-t<target> 新 工程 的 编译 目标 必 备 参数 
-p<path> 新 工程 的 保存 路 径 Ws i BL 
-t<targe> 设 定 工程 的 编译 目标 必 备 参数 
android update project -p<path> 工程 的 保存 路 径 必 备 参数 
-n<name> 工程 名 称 
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使 用 android. bat 建立 Android 工程 ,需要 选择 “开始 ”一 “运行 "> CMD 命令 ,启动 
CMD, 并 进入 二 Android SDK>/tools 目录 ,输入 命令 如 下 : 


android create project -n HelloCammandline - k edu.hrbeu.HelloCammandline -a 
HelloCommandline - t 2 - p e:\Android\workplace\HelloCammandline 


T EA KA HelloCommandline. & 44 W edu. hrbeu. HelloCommandline, Activity 
名 称 是 HelloCommandline. 编译 目标 的 ID Jy 2.39] T. FEW CR TE BE £5 HE e: \ Android N 
workplace\ HelloCommandline。 另 一 种 命令 输入 方法 如 下 : 
android create project - - name HelloCammandline - - package edu.hrbeu.HelloComandline 
~~ activity HellcCamendLine - -target 2 - -path e:\Android\ workplace\ Hel loCamrandline 
android. bat 命令 输入 后 的 运行 结果 如 图 3. 10 所 示 ,建立 了 用 于 HelloCommandline 
[ 程 的 目录 和 文件 。 使 用 命令 行 工具 创建 的 Android 工程 可 以 移动 到 其 他 目录 中 ,因为 
android. bat 在 工程 创建 过 程 中 ,在 local. properties 中 保存 了 Android SDK 的 路 径 , 因 此 
[『 程 建立 后 ,建议 不 要 改变 Android SDK 的 保存 路 径 。 


dows-1.5_r1\tools>android create proje HelloCo 
HelloCommandline -a HelloCommandline -t » Android 


ect directory: e:\Android\workplace WelloCommandline 
ctory E:\Android\workplace He 1loCommand1ine\src \edu\hrbeu He 110Conna 


Ando id \workp lace He 1loCommand Line \sre \edu\hrbeu He 1loCommand line \ 
findro id workplace He 1loCommand 1 ine \gen\edu\hrbeu He 1loCommal 


findro id\workplace He 1loCommand1ine\ 
findro id\workp He LloComme 
Androids 


HelloCommandline\re 
\workplace WelloCommandline 
ace HelloCommandline la ml 
droid \wo ace \HelloComn droidManife ml 
oid 
tory E:\Android\ ace \He1loC 
tory E: VIndroid workplace He 1loCommandline\test "c edu NhrbeuNHe11 


ace \He lloComnandline tests src \edu\hrbeu We 11oConnan| 


y E:\Android\workplace He 1loCommand1line\tests \gen\edu\hrbeu We 11 


and line 
ated directory E:\Android\workplace \HelloCommandline\test 
reated dim d workplace He 1loCommandline\test 
Hello and line te 
mmand line findroidManifest.xml 
s Nbuild.xml 


: indroidNandroid-sdk-windous-i.5 ri*tools 


图 3.10 android, bat 命令 的 运行 结果 


仔细 观察 android. bat 建立 的 目录 和 文件 ,发 现 其 中 一 些 在 Eclipse 开发 环境 中 从 未 
出 现 过 的 目录 和 文件 ,例如 build. xml、local. properties 和 tests 目录 。 这 些 新 目录 和 文 
件 的 出 现 , 主 要 是 为 了 在 构建 Android 程序 时 使 用 Apache Ant. Apache Ant 是 一 个 将 
软件 编译 .测试 .部 署 等 步骤 联系 在 一 起 的 自动 化 工具 ,多 用 于 Java 环境 中 的 软件 开发 。 
在 Android 程序 构建 中 使 用 Apache Ant, 可 以 简化 程序 的 编译 和 apk 打包 过 程 。 
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表 3.2 给 出 了 HelloCommandline 工程 的 主要 文件 和 目录 ,其 中 出 现 了 libs 和 tests 
两 个 新 目录 ,local. properties, build. properties 和 build. xml 3 个 新 文件 。 


表 3.2 HelloCommandline 工程 的 文件 和 目录 列表 


x 件 说 明 
AndroidManifest. xml 应 用 程序 声明 文件 
build. xml Ant 的 构建 文件 
default. properties 保存 编译 目标 ,由 Android 工具 自动 建立 ,不 可 手工 修改 
build. properties 保存 自 定义 的 编译 属性 


local. properties 


保存 Android SDK 的 路 径 , 仅 供 Ant 使 用 


edu\hrbeu\ HelloCommandline/ 


HelloCommandline. java Activity SERE 

bin/ 编译 脚本 输出 目录 

gen/ 保存 Ant 自动 生成 文件 的 目录 , 例如 R. java 
libs/ 私有 函数 库 目录 

e 资源 目录 

ES 源 代码 目录 

tests/ 测试 目录 


libs 目录 用 来 保存 私有 的 函数 库 文件 ,在 工程 创建 初期 是 空 文件 夹 。 

tests 目录 用 于 测试 用 途 ,在 工程 创建 初期 ,文件 夹 的 内 容 是 HelloCommandline T. 
程 所 有 文件 和 目录 的 一 个 完成 拷贝 。 

local. properties 文件 是 保存 Android SDK 的 路 径 的 文件 ,由 Android 工具 自动 建 
立 , 不 允许 进行 手工 修改 。 该 文件 的 主要 用 途 是 供 Apache Ant 寻找 Android SDK 的 保 
存 路 径 。local. properties 文件 代码 的 第 10 行 说 明了 Android SDK 的 路 径 是 E:\\ 
Android\\android-sdk-windows-1. 5 rl, 

local. properties 文件 的 代码 如 下 : 


#This file is autcmatically generated by Android Tools. 

# Do not modify this file- - YOUR CHANGES WILL BE ERASED! 

+ 

# This file must * NOT * be checked in Version Control Systems, 

# as it contains information specific to your local configuration. 


# location of the SIK. This is only used by Ant 

# For customization when using a Version Control System, please read the 
# header note. 

sdk- location- E:\\Android\ \android- sdk- windows- 1.5 r1 


说 明 :“\\” 前 一 个 为 转 义 定义 符 , 后 一 个 为 斜 杠 。 


oem o H HE 


m 
o 
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build. properties 是 保存 自 定义 的 编译 属性 的 文件 ,能 够 修改 应 用 程序 的 包 名 称 、 源 
代码 目录 和 编译 脚本 输出 目录 等 Apache Ant 编译 属性 。 在 工程 建立 初期 , build. 
properties 不 包含 任何 有 效 代 码 , 用 户 可 以 手工 修改 文件 内 容 。 如 果 需 要 修改 应 用 程序 
的 包 名 称 , 可 以 取消 build. properties 文件 代码 的 第 8 行 的 注释 符号 # ,并 将 com. 
example. myproject 替换 为 正确 的 包 名 称 。 修 改 源 代码 目录 和 编译 脚本 输出 目录 的 位 
置 , 分 别 在 build. properties 文件 代码 的 第 11 行 和 第 14 £T. 

build. properties 文件 的 代码 如 下 : 


o o A DOF QN ra 


14 


# This file is used to override default values used by the Ant build system. 
+ 

# This file must be checked in Version Control Systems, as it is 

# integral to the build system of your project. 


# The name of your application package as defined in the manifest. 
# Used by the 'uninstall' rule. 
# application- package= com.example .myproject 


# The name of the source folder. 


# source- folder- src 


# The name of the output folder. 
# out- folder- bin 


build. xml 是 Apache Ant 的 构建 文件 ,为 编译 Android 程序 提供 基础 信息 。build. 
xml 文件 代码 的 第 4 行 一 第 6 行 分 别 说 明了 三 个 属性 文件 的 名 称 , 第 8 行 一 第 14 行 说 明 
了 构建 过 程 中 使 用 到 的 库 文件 的 路 径 。 

去 除 注释 后 的 build. xml 文件 代码 如 下 : 


1 
2 
3 
4 
5 
6 
7 
8 
9 


<?xml version- "1.0" encoding= "UIF- 8"?> 
<project name= "HelloCammandline" default- "help"> 


<property file= "local .properties"/> 
<property file= "build.properties"/> 
<property file= "default .properties"/> 


<path id= "android.antlibs"> 
<pathelement path= "$ (sdk- location)/tools/lib/anttasks.jar"/» 
<pathelement path= "$ {sdk- location}/tools/lib/sdklib.jar"/> 
< pathelement path= "$ (sdk- location}/tools/lib/androidprefs.jar"/> 
<pathelement path= "$ (sdk- location)/tools/lib/apkbuilder.jar"/^ 
< pathelement path= "$ (sdk- location]/tools/lib/jarutils.jar"/» 

< /path> 


< taskdef name= "setup" 
classname= "com.android.ant.SetupTask" 


p 2 
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18 classpathref- "android.antlibs"/» 
19 
20 «setup 人 > 


21 </project> 


第 二 步 ,使 用 Apache Ant 对 HelloCommondline 工程 进行 编译 和 apk 打包 。 

如 果 读 者 还 没有 安装 Apache Ant, 可 以 在 http://ant. apache. org/bindownload. cgi 
下 载 ,网 站 提供 zip \tar. gz 和 tar. bz2 三 种 格式 下 载 ,Windows 系统 用 户 推荐 下 载 zip 格 
式 的 二 进 制 包 。 笔 者 下 载 的 Apache Ant 压缩 包 为 apache-ant-1. 7. 1-bin. zip ,版 本 号 为 
1.7.1, 并 将 其 解压 缩 在 下 :\Android 目录 下 。 

为 了 能 Apache Ant 正常 运行 ,需要 在 Windows 系统 中 添加 新 的 环境 变量 ,变量 名 
和 变量 值 参 3.3, Windows 系统 环境 变量 的 修改 位 置 可 选择 “我 的 电脑 * 一 “属性 ” 


= 高 级 ”一 “ 环境 变量 ” m “系统 变量 ”命令 。 


表 3.3 新 增 的 系统 环境 变量 


变量 名 变量 值 备 注 
JAVA_HOME C:\Program Files\Java\jdk1. 6. 0_12 新 增 变 量 
ANT_HOME E:\Android\apache-ant-1. 7. 1 新 增 变 量 
ANDROID_HOME E:\Android\android-sdk-windows-1. 5_rl 新 增 变 量 


$JAVA _ HOME/jre/lib: $JAVA _ HOME/lib: mn 
CLASSPATH - : 折 增 变量 
Pa $ JAVA_HOME/lib/tools. jar 新 增 变量 
%ANT_HOME%Nbin; %JAVA_HOME% /bin; 


?g 上 e SS m 1 E SEH 
Fan % ANDROID HOME %\ tools; 已 有 变量 


其 中 ,JAVA_HOME 是 JDK ow 目录 ,根据 JDK 实际 安装 位 置 进行 修改 ;ANT _ 
HOME 是 Apache Ant 的 安装 目录 ,根据 ge An 实际 安装 位 置 进 行 修 改 ; 
ANDROID_HOME 是 Android SDK 的 安装 ,根据 实际 安装 位 置 进行 修改 ; 
CLASSPATH 是 需要 使 用 的 库 文件 的 位 置 pee 是 可 执行 文件 的 搜索 路 径 , 将 二 Apache 
Ant>/bin,<JDK>/bin 和 二 Android SDK>/tools 三 个 目录 追加 到 原 有 的 Path 变量 
值 中 ,目录 之 间 使 用 分 号 分 隔 。 

环境 变量 设置 完毕 后 ,可 以 在 CMD 中 运行 输入 Ant 命令 ,通过 命令 的 输出 信息 判断 
环境 变量 是 否 设置 正 确 。 如 果 输 出 的 提示 包含 “Unable to locate tools. jar. Expected to 
find it in…”, 则 表明 没有 正确 设置 环境 变量 。 如 果 环 境 变量 设置 正确 ,Ant 命令 的 输出 
结果 应 如 图 3.11 所 示 。 


图 3.11 ant 命令 的 输出 结果 
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Apache Ant 已 经 可 以 正常 运行 了 ,但 在 构建 Android 程序 前 ,需要 介绍 Android 程 
序 的 数字 签名 机 制 。 在 Android 平台 上 开发 的 所 有 应 用 程序 ,在 安装 到 模拟 器 或 手机 前 
都 必须 进行 数字 签名 。 如 果 强 行将 没有 数字 签名 的 Android 程序 安装 到 模拟 器 中 ,将 返 
回 错误 提示 *Failure [INSTALL_PARSE_FAILED_ NO CERTIFICATERS]", 

在 Eclipse 开发 环境 中 ,ADT 在 将 Android 程序 安装 到 模拟 器 前 ,已 经 利用 内 置 的 
debug key 为 apk 文件 自动 做 了 数字 签名 ,这 使 用 户 无 需 自己 生产 数字 签名 的 私 钥 ,而 能 
够 利用 debug key 快速 完成 程序 调试 。 但 有 一 点 需要 注意 ,如 果 用 户 希 望 正式 发 布 自己 
的 应 用 程序 , 则 不 能 使 用 debug key, 必 须 使 用 私有 密 钥 对 Android 程序 进行 数字 签名 。 

Apache Ant 构建 Android 应 用 程序 支持 Debug 模式 和 Release 模式 两 种 构建 模式 。 
Debug 模式 是 供 调试 使 用 的 构建 模式 ,用 于 快速 测试 开发 的 应 用 程序 ,Debug 模式 自动 
使 用 debug key 完成 数字 签名 ;Release 模式 是 正式 发 布 应 用 程序 时 使 用 的 构建 模式 , 生 
成 没有 数字 签名 的 apk 文件 。 

使 用 Apache Ant 的 Debug 模式 对 HelloCommandline 工程 进行 编译 ,生成 具有 
debug key 的 apk 打包 文件 。 使 用 CMD ,在 工程 的 根 目 录 下 ,输入 ant debug. 显示 输出 
结果 如 图 3. 12 Bras. 


ing aidl files into Java classes... 


c] Compiling 1 source file to 


[echo] Converting compiled files and external libraries into bin/class 


and ing it with a debug 


ett ings \Administrator\.android\de| 


图 3.12 ant debug 的 输出 结果 


debugapk。 如 果 需 要 使 用 Release 模式 , 则 需 在 CMD 中 输入 ant release, 运 行 后 会 在 bin 
目录 中 生成 打包 文件 HelloCommandline-unsignedapk。 
apk 文件 是 Android 系统 的 安装 程序 ,上 传 到 Android 模拟 器 或 Android 手机 后 可 
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以 进行 安装 。apk 文件 本 身 是 一 个 zip 压缩 文件 ,能 够 使 用 WinRAR、UnZip 等 软件 直接 
打开 ,图 3. 13 是 用 WinRAR 打开 的 HelloCommandline-debugapk 文件 。 其 中 ,res\ 目 录 
用 来 存放 资源 文件 ;AndroidManifest. xml 是 Android 声明 文件 ;classes. dex 是 Dalvik 
虚拟 机 的 可 执行 程序 ;resources. arsc 是 编译 后 的 二 进 制 资 源 文 件 。 


$= HelloCommandline-debug.apk — WinRAR 
FO AFO TAGS) KERO Me Spo 


ET TI EN 


添加 Sa “测试 查看 删除 查找 向 导 信息 | 扫描 病毒 CS 。 自 解压 格式 


;图 E HelloCommandline-debug. apk - ZIP 压缩 文件 ， 解 包 大 小 为 5, 959 FP m 
zm 分 -大 小 | RBA SU 


e META-INF t 

(ares 资料 2009-6-2 13:16 

[4] Androi dlani fest. xnl E XML Document 2009-6-2 13:16  BEDBFD25 
[ia classes dex ^ 文件 dex 2009-6-2 13:16 502E4F20 
[d] resources. arse 文件 arse 2009-6-2 13:16 。 6A216AES 


Bit 2 文件 夹 和 3,772 FPG 个 文件 ) 
3.13 HelloCommandline-debugapk 文件 
第 三 步 , 使 用 adb. exe 将 HelloCommondline 工程 上 传 到 Android 模拟 器 中 。 
从 Android SDK 1.5 版 本 后 ,用 户 不 能 通过 双击 emulator. exe 启动 Android 模拟 
器 ,必须 在 启动 模拟 器 时 指定 所 使 用 的 AVD。AYVD 的 建立 方法 可 参考 3.1 节 , 如 果 已 经 
建立 过 AVD, 可 以 使 用 android list avds 命令 进行 查询 ,查询 结果 如 图 3. 14 所 示 。 


TINDOWS\s7stea32Ncad. BEE 


tt ings Administrators. android \avd Andro idi .5 . ave 


图 3.14 已 有 AVD 表 的 查询 结果 


笔者 建立 了 两 个 AVD ,一 个 是 3. 1 节 建 立 的 Android]. 5, 另 一 个 是 用 于 区 别 的 
Androidl.1, 分 别 对 应 1. 5 版 本 和 1. 1 版 本 的 Android 系统 。 这 里 使 用 Androidl. 5 的 
AVD 启动 模拟 器 ,在 CMD 中 输入 命令 emulator -avd Androidl. 5, 随 即 可 以 见 到 
Android 模拟 器 的 启动 界面 。 

Android 模拟 器 正常 启动 后 ,利用 adb. exe 工具 能 够 把 HelloCommandline- 
debugapk 文件 上 传 的 模拟 器 中 ,adb. exe 工具 的 命令 和 参数 可 以 参考 附录 C。 这 个 工具 
除了 能 够 在 Android 模拟 器 中 上 传 和 下 载 文件 ,还 能 够 管理 模拟 器 状态 ,是 调试 程序 时 
不 可 缺少 的 工具 之 一 。 在 CMD HE A<HelloCommandline>/bin 目录 ,输入 命令 adb 
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install HelloCommandline-debugapk ,完成 apk 程序 上 传 到 模拟 器 的 过 程 。 如 果 上 传 成 


功 ,将 显示 图 3.15 所 示 的 结果 。 


c C: MINDOWSVAsysten32lcnd. exe 


ndline\bin>adb install He 


es in @.031s) 


ocal/tnp/HelloCommandline-debug.apk 


He 1loCommandline\bin 


3.15 向 模拟 器 中 上 传 apk 文件 


apk 文件 上 传 后 ,并 不 会 在 Android 模拟 器 上 直接 


HelloCommandline 程序 。 在 图 3. 16 的 左下 角 , 能 找到 刚 
刚 安装 的 HelloCommandline 程序 , 单 击 图 标 即 可 启动 应 
用 程序 。 如 果 在 模拟 器 中 找 不 到 HelloCommandline f£ 
FF ,尝试 重新 启动 Android 模拟 器 。 因 为 Android 的 包 管 
Hak (Package Manager) 经 常 仅 在 模拟 器 启动 的 时 候 检查 
应 用 程序 的 AndroidManifest. xml 文件 ,这 就 导致 部 分 上 
传 的 Android 应 用 程序 不 能 立即 启动 。 

用 户 在 修改 HelloCommandline 工程 代码 后 ,需要 使 
用 Apache Ant 重新 编译 和 打包 应 用 程序 ,并 将 新 生成 的 
apk 文件 上 传 到 Android 模拟 器 中 。 但 如 果 新 程序 的 包 名 
称 没有 改变 , 则 在 使 用 adb. exe 上 传 apk 文件 到 模拟 器 时 ， 
会 出 现 “INSTALL_FAILD_ALREADY_EXISTS” 的 错误 
提示 ,如 图 3.17 所 示 。 


** Cz\WINDOWS\syst em32\cad. exe 


ce He LloCommand line hän 


HelloConmandline*bin 


E: \Android\workplace 


图 3.17 安装 失败 的 错误 提示 


adb install HelloConmandline-debug.apk| 


运行 ,需要 用 户 手工 启动 


Camcorder 


Lg 


Dev Tools 


Alarm Clock Browser Calculator 


SG S 


Camera Contacts Custom 


Locale 
Dialer 


Gallery 


© 


Music 


HelloAndroid 


- 


Settings 


Email 


HelloComm: Messaging 


3.16 模拟 器 中 的 应 用 程序 


此 时 ,需要 在 模拟 器 中 先 删 除 原 有 apk 文件 ,再 使 用 adb. exe 工具 上 传 新 的 apk X 
件 。 有 两 种 方法 能 够 删除 已 经 安装 在 Android 系统 中 的 apk 文件 ,一 种 是 使 用 adb 
uninstall 三 包 名 称 二 的 方法 ,例如 删除 HelloCommandline 工程 的 apk 文件 , 则 可 在 
CMD 中 输入 命令 adb uninstall edu. hrbeu. HelloCommandline, 提 示 Success 则 表示 成 功 


删除 。 另 一 种 是 使 用 adb shell rm /data/app/— & 44 fk > 


apk 的 方法 ,同样 以 删除 


HelloCommandline 工程 的 apk 文件 为 例 , 在 CMD 中 输入 下 面 的 命令 ,没有 任何 提示 则 


表示 删除 成 功 。 


adb shell m /data/app/edu.hrbeu.HelloCammandlineapk 
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如 果 仅 有 一 个 Android 模拟 器 在 运行 ,用 户 可 以 一 条 命令 完成 Android 工程 编译 、 
apk 打包 和 上 传 过 程 。 首 先 启动 CMD, 进 入 HelloCommandline 工程 的 根 目 录 下 ,输入 
adb install,adb. exe 将 自动 构建 工程 ,并 使 用 debug key 对 工程 进行 签名 ,之 后 将 apk X 
件 上 传 到 Android 模拟 器 中 。 如 果 同 时 有 两 个 或 两 个 以 上 的 Android 模拟 器 存在 ,这 种 
方法 将 会 失败 ,因为 adb. exe 不 能 确定 应 该 将 apk 文件 上 传 到 哪 一 个 Android 模拟 器 中 。 
多 次 使 用 这 种 方法 时 ,同样 需要 先 删除 模拟 器 中 已 有 的 apk 文件 。 


SI ZR 


1. 简 述 R.java 和 AndroidManefiest. xml 文件 的 用 途 。 

2. 尝试 建立 一 个 Android 1.1 版 本 的 AVD, AVD 的 名 称 为 MyAVD_1. 1。 

3. 使 用 Eclipse 建立 名 为 MyAndroid 的 工程 , 包 名 称 为 edu. hrbeu. MyAndroid, 使 
用 第 2 题 中 建立 的 AVD ,程序 运行 时 显示 Hello MyAndroid。 

4. 尝试 使 用 命令 行 方式 建立 一 个 Android 应 用 程序 ,并 完成 apk 打包 和 程序 安装 
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Android 生命 周期 


Android 生命 周期 是 从 程序 启动 到 程序 终止 的 全 过 程 。 通 过 本 章 的 学 习 可 以 让 读者 
深入 理解 Android 系统 管理 生命 周期 的 必要 性 ,并 以 Activity 为 例 说 明 Android 系统 如 
何 管理 程序 组 件 的 生命 周期 。 对 调试 方法 和 工具 的 介绍 ,有 助 于 程序 开发 人 员 快 速 找到 
程序 中 的 错误 ,而 且 可 以 对 特殊 的 事件 回调 函数 进行 调试 。 

ASSIA: 

* TM Android 系统 的 进程 优先 级 的 变化 方式 

* 了 解 Android 系统 的 四 大 基本 组 件 

* 了 解 Activity 的 生命 周期 中 各 状态 的 变化 关系 

。 掌握 Activity 事件 回调 函数 的 作用 和 调用 顺序 

。 掌握 Android 应 用 程序 的 调试 方法 和 工具 
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软件 生命 周期 是 软件 从 产生 到 废弃 所 历经 的 几 个 阶段 ,一 般 包括 可 行 性 分 析 、 开 发 
计划 ,需求 分 析 与 设计 ,编码 ,测试 和 维护 等 过 程 。Android 的 程序 生命 周期 与 软件 生命 
周期 的 定义 不 同 , 它 指 的 是 Android 进程 从 启动 到 终止 的 所 有 阶段 ,也 就 是 Android 程 
序 启动 到 停止 的 全 过 程 。 

Android 系统 一 般 是 运行 在 资源 受 限 的 硬件 平台 上 , 因 
此 资源 管理 对 Android 系统 至 关 重 要 。Android 系统 主动 管 ”高 优先 级 
理 资源 ,为 了 保证 高 优先 级 程序 正常 运行 ,可 以 在 无 任何 警告 
的 情况 下 终止 优先 级 低 的 程序 ,并 回收 其 使 用 的 系统 资源 。 
因此 Android 程序 并 不 能 控制 自身 的 生命 周期 ,而 完全 是 由 ”中 优先 级 
Android 系统 进行 调度 和 控制 的 。 

Android 系统 尽 可 能 地 不 主动 终止 应 用 程序 ,即使 生命 周 
期 结束 的 程序 也 会 保存 在 内 存 中 ,以 便 再 次 快速 启动 。 但 在 内 


低 优先 级 


存 紧 张 时 ,系统 会 根据 进程 的 优先 级 清除 进程 ,回收 系统 资源 。 ZEB 
Android 系统 中 的 进程 优先 级 如 图 4. 1 所 示 , 优 先 级 由 高 到 低 = 


分 别 为 前 台 进 程 、 可 见 进程 .服务 进程 .后 台 进 程 和 空 进 程 。 图 4.1 进程 优先 级 
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1. WAKE 


前 台 进 程 是 Android 系统 中 最 重要 的 进程 ,是 与 用 户 正在 交互 的 进程 ,包含 以 下 4 
种 情况 : 

。 进程 中 的 Activity 正在 与 用 户 进行 交互 ; 

。 进程 服务 被 Activity 调用 ,而且 这 个 Activity 正在 与 用 户 进行 交互 ; 

。 进程 服务 正在 执行 声明 周期 中 的 回调 函数 ,如 onCreate CO) , onStart CO) 或 

onDestroyO ; 

* 进程 的 BroadcastReceiver 正在 执行 onReceiveO FR C, 

Android 系统 在 多 个 前 台 进 程 同时 运行 时 ,可 能 会 出 现 资源 不 足 的 情况 ,此 时 会 清除 
部 分 前 台 进 程 , 保 证 主要 的 用 户 界面 能 够 及 时 响应 。 


2. 可 见 进 程 


可 见 进程 指 部 分 程序 界面 能 够 被 用 户 看 见 , 却 不 在 前 台 与 用 户 交 互 ,不 响应 界面 事 
件 的 进程 。 例 如 ,新 启动 的 Android 程序 将 原 有 程序 部 分 遮挡 , 原 有 程序 从 前 台 进程 变 
为 可 见 进 程 。 另 外 ,如 果 一 个 进程 包含 服务 ,上 且 这 个 服务 正在 被 用 户 可 见 的 Activity 调 
用 ,此 进程 同样 被 视 为 可 见 进 程 。 一 般 Android 系统 会 存在 少量 的 可 视 进 程 ,只 有 在 极 
端的 情况 下 ,Android 系统 才 会 为 保证 前 台 进 程 的 资源 而 清除 可 视 进 程 。 


3. 服务 进程 


一 个 包含 已 启动 服务 的 进程 就 是 服务 进程 。 服 务 没有 用 户 界面 ,不 与 用 户 直接 交 
互 ,但 能 够 在 后 台 长 期 运行 ,提供 用 户 所 关心 的 重要 功能 ,例如 播放 MP3 文件 或 从 网 络 
下 载 数据 。 因 此 ,Android 系统 除非 不 能 保证 前 台 进 程 或 可 视 进 程 所 必要 的 资源 ,否则 不 
强行 清除 服务 进程 。 


4. RAHE 


如 果 一 个 进程 不 包含 任何 已 经 启动 的 服务 ,而 且 没 有 任何 用 户 可 见 的 Activity, 则 这 
个 进程 就 是 后 台 进 程 。 例 如 ,在 一 个 仅 有 Activity 组 件 的 进程 中 ,用 户 启 动 了 新 应 用 程 
序 ,使 完全 遮挡 住 了 当前 进程 的 Activity, 则 这 个 进程 便 成 为 了 后 台 进程 。 一 般 情况 下 ， 
Android 系统 中 存在 数量 较 多 的 后 台 进 程 ,在 系统 资源 紧张 时 ,系统 将 优先 清除 用 户 较 长 
时 间 没 有 见 到 的 后 台 进 程 。 

5. SHE 

空 进程 是 不 包含 任何 活跃 组 件 的 进程 ,例如 一 个 仅 有 Activity 组 件 的 进程 , 当 用 户 
关闭 Activity 后 ,这 个 进程 就 成 为 空 进程 。 空 进程 在 系统 资源 紧张 时 会 被 首先 清除 ,但 
为 了 提高 Android 系统 应 用 程序 的 启动 速度 , Android 系统 会 将 空 进程 保存 在 系统 内 存 
中 ,在 用 户 重新 启动 该 程序 时 , 空 进程 会 被 重新 使 用 。 

在 Android 中 ,进程 的 优先 级 取决 于 所 有 组 件 中 的 优先 级 最 高 的 部 分 。 例 如 ,在 进 
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程 中 同时 包含 部 分 可 见 的 Activity 和 已 经 启动 的 服务 , 则 该 进程 是 可 见 进程 ,而 不 是 服 
务 进程 。 另 外 ,进程 的 优先 级 会 根据 与 其 他 进程 的 依赖 关系 而 变化 。 例 如 ,进程 A 的 服 
务 被 进程 B 调用 ,如 果 调 用 前 进程 A 是 服务 进程 ,进程 B 是 前 台 进程 , 则 调用 后 进程 A 
也 具有 前 台 进 程 的 优先 级 。 
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Android 应 用 程序 由 组 件 组 成 ,组 件 是 可 以 被 调用 的 基本 功能 模块 。Android 系统 利用 
组 件 实现 程序 内 部 或 程序 间 的 模块 调用 ,以 解决 代码 复 用 的 问题 ,这 是 Android 系统 非常 重 
要 的 特性 。 在 程序 设计 时 ,在 AndroidManifest. xml 中 声明 可 共享 的 组 件 , 声 明 后 其 他 应 用 
程序 可 以 直接 调用 这 些 共 享 组 件 。 例 如 程序 A 实现 了 文件 压缩 的 功能 ,并 对 外 共享 了 这 个 
组 件 ,程序 B 则 不 必 再 开发 文件 压缩 功能 ,而 直接 调用 程序 A 的 共享 组 件 即 可 。 

但 这 种 特性 存在 一 个 问题 ,如 果 共 享 组 件 所 在 的 进程 没有 启动 ,这 个 共享 组 件 如 何 
被 其 他 程序 调用 ? 为 了 解决 这 一 问题 ,Android 系统 必须 能 够 在 其 他 程序 调用 共享 组 件 
时 ,能 够 直接 启动 被 调用 的 共享 组 件 。 因 此 ,Android 系统 没有 使 用 常见 的 应 用 程序 入 口 
点 (类 似 于 Java 程序 的 Main 函数 ) 的 方法 ,而 是 允许 共享 组 件 被 Android 系统 直接 实例 
化 ,从 而 保证 能 够 调用 进程 没有 启动 的 共享 组 件 。 

Android 系统 有 4 个 重要 的 组 件 ,分 别 是 Activity、Service、BroadcaseReceiver 和 
ContentProvider, 

Activity 是 Android 程序 的 呈现 层 , 显 示 可 视 化 的 用 户 界面 ,并 接收 与 用 户 交 互 所 产 
生 的 界面 事件 ,与 “ 窗 体 ” 的 概念 非常 相似 。Android 应 用 程序 可 以 包含 一 个 或 多 个 
Activity ,一 般 在 程序 启动 后 会 呈现 一 个 Activity, 用 于 提示 用 户 程序 已 经 正常 启动 。 
Activity 在 界面 上 的 表现 形式 一 般 是 全 屏 窗 体 , 也 可 以 是 非 全 屏 悬 浮 窗 体 或 对 话 框 。 

Service 一 般 用 于 没有 用 户 界面 ,但 需要 长 时 间 在 后 台 运 行 的 应 用 。 例 如 在 播放 MP3 
音乐 时 ,使 用 Service 播放 MP3 音乐 ,可 以 在 关闭 播放 器 界面 的 情况 下 长 时 间 播 放 MP3 音 
乐 ,并 通过 对 外 公开 Service 的 通信 接口 ,控制 MP3 音乐 播放 的 启动 .暂停 和 停止 。 

BroadcaseReceiver 是 用 来 接受 并 响应 广播 消息 的 组 件 。 大 部 分 广播 消息 是 由 系统 
产生 的 ,例如 时 区 改变 .电池 电量 低 或 语言 选项 改变 等 ,但 应 用 程序 也 可 以 产生 广播 消 
息 , 例 如 数据 下 载 完 毕 等 。Broadcast receiver 不 包含 任何 用 户 界面 ,但 可 以 通过 启动 
Activity 或 者 Notification 通知 用 户 接收 到 重要 信息 。Notification 能 够 通过 多 种 方法 提 
示 用 户 , 包 括 闪 动 背景 灯 、 震 动 设备 .发 出 声音 或 在 状态 栏 上 放置 一 个 持久 的 图 标 等 。 

ContentProvider 是 Android 系统 提供 的 一 种 标准 的 共享 数据 的 机 制 ,应 用 程序 可 以 
通过 ContentProvider 访问 其 他 应 用 程序 的 私有 数据 。 私 有 数据 可 以 是 存储 在 文件 系统 
中 的 文件 ,也 可 以 是 SQLite 中 的 数据 库 。Android 系统 内 部 也 提供 一 些 内 置 的 
ContentProvider ,能 够 为 应 用 程序 提供 重要 的 数据 信息 ,例如 联系 人 信息 和 通话 记录 等 。 

Android 系统 通过 组 件 机 制 , 有 效 地 降低 了 应 用 程序 的 耦合 性 ,使 向 其 他 应 用 程序 共 
享 私有 数据 (ContentProvider) 和 调用 其 他 程序 的 私有 模块 (Service) 成 为 可 能 。 

所 有 Android 组 件 都 具有 自己 的 生命 周期 , 称 为 组 件 声明 周期 ,是 从 组 件 建 立 到 组 
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件 销毁 的 整个 过 程 。 在 这 个 过 程 中 ,组 件 会 在 可 见 、 不 可 见 、 活 动 、 非 活动 等 状态 中 不 断 
变化 ,4. 3 节 将 主要 对 Activity 的 生命 周期 进行 详细 介绍 。 


43 Activity 生命 周期 


Activity 生命 周期 指 Activity 从 启动 到 销毁 的 过 程 ,在 这 个 过 程 中 ,Activity 一 般 表 
现 为 4 种 状态 ,分 别 是 活动 状态 .暂停 状态 .停止 状态 和 非 活 动 状态 。(1) 活 动 状 态 , 当 
Activity 在 用 户 界 面 中 处 于 最 上 层 , 用 户 完 全 看 不 到 ,能 够 与 用 户 进行 交互 , 则 这 个 
Activity 处 于 活动 状态 。(2) 和 暂停 状态 , 当 Activity 在 界面 上 被 部 分 遮挡 ,该 Activity 不 
再 处 于 用 户 界面 的 最 上 层 , 且 不 能 够 与 用 户 进行 交互 , 则 这 个 Activity 处 于 暂停 状态 。 
(3) 停 止 状态 , 当 Activity 在 界面 上 能 完全 不 被 用 户 看 到 ,也 就 是 说 这 个 Activity 被 其 他 
Activity 全 部 遮挡 , 则 这 个 Activity 处 于 停止 状态 。(4) 非 活动 状态 ,活动 状态 .暂停 状态 
和 停止 状态 是 Activity 的 主要 状态 ,不 在 以 上 三 种 状态 中 的 Activity 则 处 于 非 活动 状态 。 

Activity 的 4 种 状态 的 变换 关系 如 图 4. 2 RAS. Activity 启动 后 处 于 活动 状态 ,此 时 
的 Activity 位 于 界面 的 最 上 层 , 是 与 用 户 正 在 进行 交互 的 组 件 , 因 此 Android 系统 会 努力 
保证 处 于 活动 状态 Activity 的 资源 需求 ,资源 紧张 时 可 终止 其 他 状态 的 Activity s 如果 用 
户 启 动 了 新 的 Activity ,部 分 遮挡 了 当前 的 Activity, AY Activity 是 半 透 明 的 , 则 当前 
的 Activity 转换 为 暂停 状态 ,Android 系统 仅 在 为 处 于 活动 状态 的 Activity 释放 资源 时 
才 终 止 处 于 暂停 状态 的 Activity; 如 果 用 户 启 动 新 的 Activity 完全 遮挡 了 当前 的 
Activity, 则 当前 的 Activity 转变 为 停止 状态 ,停止 状态 的 Activity 将 优先 被 终止 ;活动 状 
态 的 Activity 被 用 户 关 闭 后 ,或 暂停 状态 或 停止 状态 的 Activity 被 系统 终止 后 , Activity 
便 进 入 了 非 活动 状态 。 


| 
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4.2 Activity 状态 变换 图 


为 能 够 更 好 地 理解 Activity 的 生命 周期 ,还 需要 对 Activity 栈 做 一 个 简要 的 介绍 。 
Activity 栈 保 存 了 已 经 启动 且 没 有 终止 的 所 有 Activity, 并 遵循 “后 进 先 出 ”的 规则 。 如 
图 4. 3 ras , 栈 顶 的 Activity 处 于 活动 状态 , 除 栈 顶 以 外 的 其 他 Activity 处 于 暂停 状态 或 
停止 状态 ,而 被 终止 的 Activity 或 已 经 出 栈 的 Activity 的 Activity 则 不 在 栈 内 。 

Activity 的 状态 与 其 在 Activity 栈 的 位 置 有 着 密切 的 关系 ,不 仅 如 此 ,Android 系统 
在 资源 不 足 时 ,也 是 通过 Activity 栈 来 选择 哪些 Activity 是 可 以 被 终止 的 。 一 般 来 讲 ， 
Android 系统 会 优先 选 终 止 处 于 停止 状态 , 且 位 置 靠 近 栈 底 的 Activity. 因为 这 些 
Activity 启动 顺序 最 靠 前 ,而 且 在 界面 上 用 户 是 看 不 到 的 。 
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图 4.3 Activity 栈 


随 着 用 户 在 界面 的 操作 和 Android 系统 对 资源 的 管理 , Activity 不 断 变化 在 Activity TE 
的 位 置 ,其 状态 也 不 断 在 4 种 状态 中 转变 。 为 了 能 够 让 Android 程序 了 解 自身 状态 的 变化 ， 
Android 系统 提供 了 多 个 的 事件 回调 函数 ,在 事件 回调 函数 添加 相关 代码 ,就 可 以 在 
Activity 状态 变化 时 完成 适当 的 工作 。 下 面 的 代码 给 出 了 Activity 的 主要 事件 回调 函数 。 


t 
2 
3 
4 
5 
6 
学 
8 
9 


} 


public class MyActivity extends Activity { 


protected void onCreate (Bundle savedInstanceState) ; 
protected void onStart () ; 

protected void onRestart () ; 

protected void onResume () ; 

protected void onPause () ; 

protected void onStop(); 

protected void onDestroy() ; 


这 些 事 件 回调 函数 何 时 被 调用 ,具体 用 途 是 什么 ,以 及 是 否 可 以 被 Android 系统 终 
止 ,可 以 参考 表 4.1, 


表 4.1 Activity 生命 周期 的 事件 回调 函数 


函数 是 否 可 终止 说 明 

GU. s Activity 启动 后 第 一 个 被 调用 的 函数 ,常用 来 进行 Activity 的 初始 
i 化 ,例如 创建 View、 绑 定数 据 或 恢复 信息 等 
onStart() 否 当 Activity 显示 在 屏幕 上 时 ,该 函数 被 调用 
onRestart() 否 当 Activity 从 停止 状态 进入 活动 状态 前 ,调用 该 函数 

R O 5 当 Activity 能 够 与 用 户 交互 ,接受 用 户 输 入 时 ,该 函数 被 调用 。 此 时 
ES 的 Activity 位 于 Activity 栈 的 栈 顶 

Pigs. " 当 Activity 进入 暂停 状态 时 ,该 函数 被 调用 。 一 般 用 来 保存 持久 的 
sni 数据 或 释放 占用 的 资源 
onStop() 是 当 Activity 进入 停止 状态 时 ,该 函数 被 调用 
onDestroy() 是 在 Activity 被 终止 前 , 即 进入 非 活动 状态 前 ,该 函数 被 调用 
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除了 Activity 生命 周期 的 事件 回调 函数 以 外 ,还 有 onRestoreInstanceState C) H 
onSavelInstanceState() 两 个 函数 经 常会 被 使 用 ,用 于 保存 和 恢复 Activity 的 状态 信息 , 例 
如 用 户 在 界面 中 选择 的 内 容 或 输入 的 数据 等 。 这 两 个 函数 不 是 生命 周期 的 事件 回调 函 
数 , 不 会 因为 Activity 的 状态 变化 而 被 调用 ,但 在 下 述 的 情况 下 会 被 调用 : Android 系统 
因为 资源 紧张 需要 终止 某 个 Activity, 但 这 个 Activity 在 未 来 的 某 一 时 刻 还 会 显示 在 屏 
wk. 

举 个 例子 说 明 这 两 个 函数 是 如 何 被 调用 的 。 如 用 户 启动 Activity A, 然 后 直接 又 启 
BH Activity B. 这 时 系统 资源 不 足 ,需要 终止 Activity A, 则 会 调用 Activity A 的 
onSaveInstanceState() 来 保存 Activity A 的 状态 信息 ; 当 用 户 关闭 了 Activity B Hf. 
Activity B 的 onSaveInstanceState() 不 会 被 调用 ,因为 是 用 户主 动 关闭 Activity B 而 不 是 
系统 终止 ,而 且 Activity B 不 会 再 显示 在 屏幕 上 ; 当 Activity A 重新 显示 在 屏幕 上 后 ， 
Activity A 会 调用 onRestoreInstanceState() 用 以 恢复 之 前 保存 的 Activity A 的 状态 
信息 。 

Activity 状态 保存 和 恢复 函数 onRestoreInstanceState() 和 onSaveInstanceState() 的 
说 明 参 见 表 4. 2。 


表 4.2. Activity 状态 保存 /恢复 的 事件 回调 函数 


Ed 数 是 否 可 终止 说 RB 
Android 系统 因 资 源 不 足 终止 Activity 前 调用 该 函数 ,用 以 
onSavelnstanceState() f 保存 Activity 的 状态 信息 , 供 onRestoreInstanceState O 3X 
onCreate() 恢 复 之 用 
EE d StateO s 恢复 onSavelnstanceState () 保存 的 Activity 状态 信息 ,在 
MEE onStart( fll onResume () 之 间 被 调用 


FR C onSaveInstanceState() 保 存 的 Activity 状态 信息 ,也 可 以 在 onCreate O 函数 中 
进行 恢复 ,但 onRestoreInstanceState() 使 用 起 来 更 加 方便 ,也 使 得 代码 更 加 整洁 。 因 为 
使 用 者 可 以 在 onCreateO 函数 中 完成 初始 化 工作 结束 后 ,再 在 onRestoreInstanceState() 
决定 是 否 使 用 默认 设置 或 恢复 保存 的 数据 。 

在 Activity 的 生命 周期 中 ,并 不 是 所 有 的 事件 回调 函数 都 将 被 执行 ,但 如 果 被 调用 
则 一 定 遵循 图 4.4 所 描述 的 调用 顺序 。 

从 图 4.4 中 可 知 ,Activity 的 生命 周期 可 分 为 全 生命 周期 \ 可 视 生命 周期 和 活动 生命 
周期 。 每 种 生命 周期 中 包含 不 同 的 事件 回调 函数 。 

全 生命 周期 是 从 Activity 建立 到 销毁 的 全 部 过 程 , WT onCreate(), 结 束 于 
onDestroy() 。 一 般 情况 下 ,使 用 者 在 onCreate() 中 初始 化 Activity 所 能 使 用 的 全 局 资源 
和 状态 ,并 在 onDestroy() 中 释放 这 些 资源 。 例 如 ,Activity 中 使 用 后 台 线 程 下 载 网 络 数 
据 , 则 在 onCreate() 中 创建 线程 ,在 onDestroy() 中 停止 并 销毁 线程 。 在 一 些 极端 的 情况 
下 ,Android 系统 会 不 调用 onDestroy() 了 艺 数 ,而 直接 终止 进程 。 

可 视 生 命 周 期 是 Activity 在 界面 上 从 可 见 到 不 可 见 的 过 程 ,开始 于 onStart O ,结束 
于 onStopO 。onStart() 一 般 用 来 初始 化 或 启动 与 更 新 界面 相关 的 资源 。onStop() 一 般 
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用 来 暂停 或 停止 一 切 与 更 新 用 户 界 面相 关 的 线程 .计时 器 和 服务 ,因为 在 调用 onStop() 
Ja» Activity 对 用 户 不 再 可 见 ,更 新 用 户 界面 也 就 没有 任何 实际 意义 。onRestart() 函数 
在 onSart() 前 被 调用 ,用 来 在 Activity 从 不 可 见 变 为 可 见 的 过 程 中 ,进行 一 些 特定 的 处 
理 过 程 。 因 为 Activity 不 断 从 可 见 变 为 不 可 见 , 再 从 不 可 见 变 为 可 见 , 所 以 onStart() 和 
onStop() 会 被 多 次 调用 。 另 外 ,onStart() 和 onStop () 也 经 常 被 用 来 注册 和 注销 
BroadcastReceiver, 例 如 使 用 者 可 以 在 onStart() 中 注册 一 个 BroadcastReceiver, 用 来 监视 某 
些 重要 的 广播 消息 ,并 使 用 这 些 消息 更 新 用 户 界面 中 的 相关 内 容 , 并 可 以 在 onStop() 中 注 
销 BroadcastReceiver。 

1 2 3 4 el 7 8 9 


onSave 
InstanceState 


onRestore 
InstanceState 


onResume onPause 


onCreate 6 


活动 生命 周期 
可 视 生命 周期 
全 生命 周期 


4.4 Activity 事件 回调 函数 的 调用 顺序 


活动 生命 周期 是 Activity 在 屏幕 的 最 上 层 , 并 能 够 与 用 户 交 互 的 阶段 ,开始 于 
onResumeO ,结束 于 onPause()。 例 如 ,在 手机 进入 休眠 状态 时 ,处 于 活动 生命 周期 的 
Activity 会 调用 onPause(), 当 手机 从 休眠 状态 被 唤醒 后 , 则 会 调用 onResume()。 因 为 
在 Activity 的 状态 变换 过 程 中 onResume() 和 onPause() 经 常 被 调用 ,因此 这 两 个 函数 中 
应 使 用 更 为 简单 高效 的 代码 。 

在 表 4.1 和 表 4. 2 中 ,是 否 可 终止 表示 事件 回调 函数 在 执行 过 程 中 或 返回 后 是 否 
可 以 被 Android 系统 终止 ,否定 答案 表示 在 函数 从 被 调用 后 ,直到 函数 返回 前 , Android 
系统 不 能 够 终止 该 进程 ;肯定 答案 表示 当前 的 函数 返回 后 ,Android 系统 可 以 随时 终止 该 
进程 。 从 图 4.4 的 Activity 事件 回调 函数 的 调用 顺序 上 分 析 ,onPause() 是 第 一 个 被 标识 
为 “可 终止 ?的 函数 ,因此 在 onPause() 返 回 后 ,后 续 的 onStop() 和 onDestroy() 随 时 能 被 
Android 系统 终止 ,也 就 是 说 系统 需要 终止 进程 时 ,onPause() 是 唯一 一 个 能 够 完整 运行 
事件 回调 函数 。 因 此 ,onPause() 常 用 来 保存 持久 数据 ,如 界面 上 的 用 户 的 输入 信息 等 。 
很 多 时 候 使 用 者 不 能 清楚 何 时 该 使 用 onPause() , 何 时 该 使 用 onSaveInstanceStateO , 因 
为 两 个 函数 都 可 以 用 来 保存 界面 的 用 户 输入 数据 。 其 主要 区 别 在 于 两 个 函数 保存 数据 
的 性 质 和 方法 不 同 ,onPause() 一 般 用 于 保存 持久 性 数据 ,并 将 数据 保存 在 存储 设备 上 的 
文件 系统 或 数据 库 系 统 中 的 ;而 onSavelnstanceState O 主要 用 来 保存 动态 的 状态 信息 ， 
信息 一 般 保存 在 Bundle 中 。Bundle 是 能 够 保存 多 种 格式 数据 的 对 象 ,在 onSaveInstance- 
State() 保 存在 Bundle 中 的 数据 ,系统 在 调用 onRestoreInstanceState() 和 onCreate() 时 ， 
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会 同样 利用 Bundle 将 数据 传递 给 函数 。 

为 了 能 够 更 好 地 理解 Activity 事件 回调 函数 的 调用 顺序 ,下 面 建立 一 个 新 的 
Android 工程 来 进行 说 明 。 工 程 名 称 ActivityLifeCycle, 包 名 称 edu. hrbeu. ActivityLife- 
Cycle. Activity 名 称 ActivityLifeCycle。 下 面 的 代码 是 ActivityLifeCycle. java 文件 的 代 
码 , 其 余 代码 使 用 自动 生成 的 代码 。 


vo o A o D e o HM ro 


o o 200 Ss Läb o 


LE NN 


package edu.hrbeu.ActivityLifeCycle; 
import android.app.Activity; 
import android.os.Bundle; 


import android.util.Log; 


public class ActivityLifeCycle extends Activity ( 


private static String TAG- "LIFTCYCLE"; 
@ Override // 完 全 生命 周期 开始 时 被 调用 ,初始 化 Activity 
public void onCreate (Bundle savedInstanceState) { 

super .onCreate (savedInstanceState) ; 

setContentView (R. layout .main) ; 

Log.i (TAG, "(1) onCreate()"); 


@ Override // 可 视 生命 周 期 开始 时 被 调用 ,对 用 户 界面 进行 必要 的 更 改 
public void onStart() ( 

super .onStart () 7 

Iog.i(TAG, "(2) onStart 0") ; 


@ Override /在 cnstart() 后 被 调用 ,用 于 恢复 onSavelInstanoe State() 保 存 的 用 
户 界面 信息 
public void onRestoreInstanceState (Bundle savedInstanceState) { 
super .onRestoreInstanceState (savedInstanceState) ; 
Log.i (TAG, "(3) onRestoreInstanceState()"); 


@ Override /在 活动 生命 周期 开始 时 被 调用 ,恢复 被 onPause() 停 止 的 用 于 
界面 更 新 的 资源 
public void onResume() { 
super .onResume () ; 
Log-i(TAG, "(4) onResume "); 


@ Override // 在 onResume () 后 被 调用 ,保存 界面 信息 
public void onSaveInstanceState (Bundle savedInstanceState) { 
super .onSaveInstanceState (savedInstanceState) ; 
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37 Log.i (TAG, "(5) onSaveInstanceState () ") ; 

38 ) 

39 

40 @ Override // 在 重新 进入 可 视 生 命 周期 前 被 调用 , 载 人 界面 所 需要 的 更 改 信息 
4 public void onRestart() { 

42 Super .onRestart () ; 

43 log.i (TAG, "(6) onRestart Q0") ; 

44 } 

45 

46 @ Override // 在 活动 生命 周期 结束 时 被 调用 ,用 来 保存 持久 的 数据 或 释放 占用 的 资源 
47 public void onPause() { 

48 super .onPause () ; 

49 Log.i (TAG, "(7) onPause()") ; 

50 } 

51 

52 @ Override 


// 在 可 视 生命 周期 结束 时 被 调用 ,一 般 用 来 保存 持久 的 数据 或 释放 占用 的 资源 


53 public void onStop() { 

54 super.onStop() ; 

55 Iog.i(TAG, "(8) onStop()"); 
56 ) 

5] 

58 @ Override /在 完全 生命 周期 结束 时 被 调用 ,释放 资源 ,包括 线程 .数据 连接 等 
59 public void onDestroy() { 

60 super .onDestroy () ; 

61 Log.i (TAG, "(9) onDestroy()"); 
62 } 

6 } 


上 面 的 程序 主要 通过 在 生命 周期 函数 中 添加 "日 志 点 ”的 方法 进行 调试 ,程序 的 运行 
结果 将 会 显示 在 LogCat 中 。LogCat 和 “日 志 点 ”的 使 用 方法 ,请 参考 4. 4. 1 节 内 容 。 为 
了 显示 结果 易于 观察 和 分 析 , 在 LogCat 设置 过 滤器 LifeCycleFilter, 过滤 方法 选择 by 
Log Tag, 过 滤 关 键 字 为 LIFTCYCLE。 日 志 信 息 中 的 数字 标识 与 图 4.4 的 函数 编号 
=m 

1) 全 生命 周期 

为 了 观察 Android 程序 启动 和 关闭 时 调用 生命 周期 函数 的 顺序 ,首先 正常 启动 
ActivityLifeCycle, 然 后 按 下 模拟 器 的 “返回 键 ” ,关闭 ActivityLifeCycle。LogCat 的 输出 
结果 如 图 4. 5 所 示 。 

从 图 4.5 可 以 得 知 ,函数 调用 顺序 如 下 : onCreate() > onStart O > onResume() 一 
onPauseO —onStopO —onDestroy O 。 

TE Activity 启动 时 ,系统 首先 调用 onCreate O 函数 分 配 资源 , 然 调 用 onStart O 将 
Activity 显示 在 屏幕 上 ,之 后 调用 onResume() 获 取 屏 幕 焦点 ,使 Activity 能 够 接受 用 户 
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的 输入 ,这 时 用 户 就 能 够 正常 使 用 这 个 Android 程序 了 。 用 户 单 击 “ 回 退 键 ” 或 Activity 
调用 finish O 函数 时 ,会 导致 Activity 关闭 ,系统 会 相继 调用 onPause() . onStop © 和 
onDestroy O ,释放 资源 并 销毁 进程 。 因 为 Activity 关闭 后 ,除非 用 户 重 新 启动 应 用 程序 ， 
否则 这 个 Activity 不 会 在 出 现在 屏幕 上 ,因此 系统 直接 调用 onDestroy() 销 毁 了 进程 ,上 且 
没有 调用 onSavelnstanceStateO 函数 来 保存 Acitivity KAS. 


Message 
22 LIFECYCLE (1) onCreate() 
22: LIFECYCLE (2) onStart() 
223 LIFECYCLE (4) onResune() 
23 LIFECYCLE (7) enPause() 


23: LIFECYCLE (8) onStop() 
23 LIFECYCLE (3) enDestroy() 


4.5 启动 和 关闭 ActivityLifeCycle 的 LogCat 输出 


2) 可 视 生 命 周期 

在 Activity 启动 后 ,如 果 启 动 其 他 的 程序 , 原 有 的 Activity 会 被 新 启动 程序 的 
Activity 完全 遮挡 ,因此 原 有 Activity 会 进入 停止 状态 ;如 果 将 新 启动 的 程序 关闭 , 则 原 
有 Activity 从 停止 状态 恢复 到 活动 状态 。 为 了 能 够 分 析 上 述 状态 转换 过 程 中 的 函数 调 
用 顺序 ,首先 正常 启动 ActivityLifeCycle, 然 后 通过 “呼出 /接听 键 " 启 动 内 置 的 拨号 程序 ， 
再 通过 “返回 键 ” 退 出 拨号 程序 ,使 ActivityLifeCycle 重新 显示 在 屏幕 中 。LogCat 的 输出 
结果 如 图 4.6 所 示 ,ActivityLifeCycle 启动 时 调用 的 函数 没有 在 LogCat 中 显示 。 


LIFECYCLE onPause() 


LIFECYCLE onStop() 
LIFECYCLE onRestart() 
LIFECYCLE onStart() 
LIFECYCLE onResune( ) 


4.6 可 视 生 命 周期 的 LogCat 输出 


从 图 4.6 可 以 得 知 , 函 数 调用 顺序 如 下 : onSaveInstanceState ( ) 一 onPause() 一 
onStopO —onRestart 0 —onStart ) c onResumeO 。 

Activity 启动 后 , 当 内 置 的 拨号 程序 被 启动 时 , 原 有 的 Activity 被 完全 覆盖 ,系统 首 
先 调 用 onSavelnstanceState() 函数 保存 Activity 状态 ,因为 界面 上 不 可 见 的 Activity 可 
能 被 系统 终止 ;系统 然后 调用 onPause() 和 onStop() ,停止 对 不 可 见 Activity 的 更 新 。 在 
用 户 关闭 拨号 程序 后 ,系统 调用 onRestart() 恢 复 需 要 界面 上 需要 更 新 的 信息 ,然后 调用 
onStart ( ) 和 onResume ( ) 重新 显示 Activity. 并 接受 用 户 交 互 。 系 统 调 用 了 
onSaveInstanceState () 保存 Activity 的 状态 ,因为 进程 没有 被 终止 ,所 以 没有 调用 
onRestoreInstanceState() 恢 复 保存 的 Activity 状态 。 

如 果 用 户 在 Dev "Tools Development Settings 一 Immediately destroy activities 
CIDA) FIFA IDA ,被 其 他 程序 遮挡 的 Activity 会 被 立即 终止 ,这 样 被 谈 挡 的 Activity 重 
新 显示 在 屏幕 上 时 ,系统 会 调用 onRestoreInstanceState() 恢 复 Activity 销毁 前 的 状态 。 


ay 
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从 图 4.7 可 以 得 知 , 函 数 调用 顺序 如 下 : onSavelnstanceState ( ) 一 onPause() 一 
onStop ( ) > onDestroy ( ) > onCreate ( ) > onStart ( ) > onRestoreInstanceState ( ) 一 


onResume( 。 


| pid | tag 
LIFECYCLE 


LIFECYCLE onStop() 
LIFECYCLE onDestroy() 
LIFECYCLE onCreate() 


LIFECYCLE onStart() 
LIFECYCLE onRestoreInstanceState() 
34.074 I 779 LIFECYCLE onResune() 


| 


4.7 开启 IDA 的 可 视 生 命 周 期 LogCat 输出 


与 关闭 IDA 相 比 , Activity 被 拨号 程序 遮挡 后 ,系统 调用 了 onDestroy() 终 止 了 
ActivityLifeCycle 进程 ,这 个 函数 的 调用 完全 是 因为 Android 系统 开启 了 IDA 进行 调 
试 ;在 拨号 程序 被 关闭 后 ,ActivityLifeCycle 的 Activity 应 该 重新 显示 在 屏幕 上 ,但 因为 
系统 已 经 终止 了 进程 ,因此 需要 重新 启动 ActivityLifeCycle, 因 为 Activity 被 系统 终止 ， 
因此 系统 调用 了 onRestoreInstanceState() 来 恢复 之 前 onSaveInstanceState O PR RUR Ce 
的 Activity 状态 ,其 他 的 函数 调用 顺序 与 程序 启动 过 程 的 调用 顺序 相同 。 

3) 活动 生命 周期 

Activity 启动 后 ,如 果 被 其 他 程序 部 分 遮挡 ,或 手机 进入 休眠 状态 ,这 个 Activity XE 
人 暂停 状态 。 为 了 分 析 活 动 生命 周期 中 的 函数 调用 顺序 ,首先 启动 ActivityLifeCycle, 然 
后 通过 “ 挂 断 键 ” 使 模拟 器 进入 休眠 状态 ,然后 再 通过 “ 挂 断 键 ” 唤 醒 模 拟 器 。 此 时 LogCat 
的 输出 结果 如 图 4. 8 Bro. 


Log (8) | LifeCycleFilter 


Tine | | pid | tag | Message 

06-07 04:47:13.673 I 779 LIFECYCLE (5) onSaveInstanceState() 
06-07 04:47:13.673 I 779 LIFECYCLE (7) onPause() 

06-07 04:47:15.038 I 779 LIFECYCLE (4) onResune( ) 


——— T€—— É— meáÁ—ÀÓ( 


4.8 活动 生命 周期 的 LogCat 输出 


从 图 4.8 可 以 得 知 ,函数 调用 顺序 如 下 : onSaveInstanceState( ) -onPause() > 
onResume() 。 

Activity 进入 休眠 状态 前 ,系统 首先 调用 onSaveInstanceState() 保 存 Activity 的 状 
态 ,然后 调用 onPause() 停 止 与 用 户 交 互 ; 在 系统 被 唤醒 后 ,系统 调用 onResume() 恢 复 与 
用 户 的 交互 。 
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在 Android 程序 开发 过 程 中 ,出 现 错误 (Bug) 是 不 可 避免 的 事情 。 一 般 情 况 下 ,语法 
错误 会 被 集成 开发 环境 检测 到 ,并 提示 使 用 者 错误 的 位 置 以 及 修改 方法 。 但 逻辑 错误 就 
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的 定位 和 分 析 是 件 困 难 的 事情 ,尤其 程序 是 代码 量 较 大 且 结构 复杂 的 应 用 程序 , 仅 凭 直 
觉 很 难 快速 找到 并 解决 问题 。 因 此 ,Android 系统 提供 了 几 种 调试 工具 ,用 于 定位 、 分 析 
及 修复 程序 中 出 现 的 错误 ,这些 工具 包括 LogCat 和 DevTools。 


LogCat 


LogCat 是 用 来 获取 系统 日 志 信 息 的 工具 ,并 可 以 显示 在 Eclipse 集成 开发 环境 中 。 
LogCat 能 够 捕获 的 信息 包括 Dalvik 虚拟 机 产生 的 信息 、 进 程 信息 、ActivityManager fri 
息 、PackagerManager 信息 、Homeloader 信息 、 
WindowsManager 信息 、Android 运行 时 信息 和 
应 用 程序 信息 等 等 。 在 Eclipse 的 默认 开发 模 
式 下 没有 LogCat 的 显示 页 ,用 户 可 以 使 用 
Windows Show View — Other 打开 Show 
View 的 选择 菜单 ,然后 在 Andoird- LogCat 中 
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Show View 


type filter text 


B- General 

DC Android 
@ Devices 
Enulator Control 
Q File Explorer 
@ Heap 
a 


选择 LogCat, 如 图 4. 9 所 示 。 

这 样 ,LogCat 便 显 示 在 Eclipse 的 下 方 区 
域 ,如 图 4. 10 所 示 。LogCat 的 右上 方 的 5 个 字 
HEVI CD] COI] CW TRI LE] Z8 5 种 不 同类 
型 的 日 志 信息 ,分 别 是 详细 (Verbose) 信 息 、 调 
iX (Debug) fii E 38i 457 CInfo) fei E , 8845 (Warn) 
和 错误 (Error) 信 息 。 不 同类 型 日 志 信 息 的 级 别 
是 不 相同 的 ,级 别 最 高 的 是 错误 信息 ,其 次 是 警 


9 Resource Explorer 


X Threads 
iR Ant 
B-S cvs 
D E Debug 
DC Help 
@ Java 


@ Java Browsing 
(o Mylyn = 
Use F2 to display the description for a selected view. 


mm 


4.9 Show View 中 选择 LogCat 


告 信 息 , 然 后 是 通知 信息 和 调试 信息 ,级 别 最 低 
的 是 详细 信息 。 在 LogCat 中 ,用 户 可 以 通过 5 个 字母 图 标 选择 显示 的 信息 类 型 ,级 别 高 
于 所 选 类 型 的 信息 也 会 在 LogCat 中 显示 ,但 级 别 低 于 所 选 类 型 的 信息 则 不 会 被 显示 。 

即使 用 户 指定 了 所 显示 日 志 信 息 的 级 别 , 仍 然 会 产生 很 多 日 志 信 息 , 很 容易 让 用 户 
不 知 所 措 。LogCat 还 提供 了 “过 滤 ” 功 能 ,在 右上 角 的 “十 ”号 和 “一 ”号 ,分 别 是 添加 和 删 
除 过 滤器 。 用 户 可 以 根据 日 志 信息 的 标签 CTag) 、 产 生日 志 的 进程 编号 (Pid) 或 信息 等 级 
(Level) ,对 显示 的 日 志 内 容 进行 过 滤 。 

在 Android 程序 调试 过 程 中 ,首先 需要 引入 android. util. Log 包 , 然 后 使 用 Log. vC), 
Log. dC ), Log. iC ) Log. w( ) 和 Log. eC ) 五 个 函数 在 程序 中 设置 “日 志 点 ”。 每 当 程序 运 
行 到 “日 志 点 ”时 ,应 用 程序 的 日 志 信 息 便 被 发 送 到 LogCat 中 ,使 用 者 可 以 根据 “日 志 点 ” 
信息 是 否 与 预期 的 内 容 一 致 ,判断 程序 是 否 存 在 错误 。 之 所 以 使 用 5 个 不 同 的 函数 产生 
日 志 , 主 要 是 为 了 区 分 日 志 信 息 的 类 型 ,其 中 ,Log. v( ) 用 来 记录 详细 信息 ,Log. dC ) 用 
来 记录 调试 信息 ,Log.i( ) 用 来 记录 通告 信息 ,Log. wt ) 用 来 记录 警告 信息 ,Log. e) 
来 记录 通 错误 信息 。 

在 下 面 的 程序 中 ,演示 了 Log 类 的 具体 使 用 方法 。 
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标签 对 日 志 ; 


wo o A Ao & UON o 


o oc 20050 ln^5o0 


N 
o 


package edu.hrbeu.LogCat; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


public class LogCat extends Activity { 
final static String TAG- "LOGCAT"; 


@ Override 


public void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) ; 
setContentView (R. layout .main) ; 


Log.v (TAG, "Verbose") ; 
Log.d (TAG, "Debug" ; 
Iog.i (TAG, " Info"); 
Log.w (TAG, "Wam") ; 
Log.e (TAG, "Error"); 


} 


区 Problems| @ Javadoc |9 Declaration [E Console |[] Properties [ [Jr 


@OOOO *?-u--O 


为 了 使 用 Log 类 中 的 函数 ,首先 在 程序 第 5 行 引 入 android. util. Log 包 ; 然 后 在 第 8 
行 定义 标签 ,标签 帮助 用 户 在 LogCat 中 找到 目标 程序 生成 的 日 志 信 息 , 同 时 也 能 够 利用 
个 详细 信息 ,Log. v( ) 函 数 的 第 一 个 参数 是 日 志 的 
标签 ,第 二 个 参数 是 实际 的 信息 内 容 ;第 15 行 到 第 18 行 分 别 产 生 了 调试 信息 、 通 告 信 


dalvikvm 


Debugger has detached. object registry had 1 entries 


dalvikvm 
dalvikva 
ActivityMa 
ActivityMa 
jdvp 
LIFECYCLE 
LIFECYCLE 
LIFECYCLE 
ActivityMa 
dalvikva 


d "nS" a 


VM cleaning up 

LinearAlloc 0x0 used 639228 of 4194304 (15%) 

Activity pause timeout for HistoryRecord(436711d8 (com android 
Start proc edu hrbeu ActivityLifeCycle for activity edu.hrbeu 
received file descriptor 10 from ADI 

(1) enCreate() 

(2) enStart() 

(4) onResune() 

Displayed activity edu hrbeu ActivityLifeCycle^ ActivityLifeCy,,| 
GC freed 602 objects / 33280 bytes in 258ns | 


4.10 Eclipse 中 的 LogCat 


息 .警告 信息 和 错误 信息 。 


行 过 滤 ;第 14 行 记录 一 


程序 运行 后 ,LogCat 捕获 得 到 应 用 程序 发 送 的 日 志 信息 ,显示 结果 如 图 4. 11 所 示 。 
在 LogCat 中 显示 了 标签 为 LOGCAT 的 日 志 信 息 共 5 条 ,并 以 不 同 颜色 加 以 显示 。 可 


见 ,LogCat 对 不 同类 型 的 信息 使 用 了 不 同 的 颜色 加 以 区 别 。 


如 果 能 够 使 用 LogCat 的 过 滤器 , 则 可 以 使 显示 的 结果 更 加 清晰 。 下 面 使 用 在 
LogCat 右上 角 的 “十 ”号 ,添加 一 个 名 为 LogcatFilter 的 过 滤器 ,并 设置 过 滤 条 件 为 “ 标 


签 二 LOGCAT”, 具 体 设 置 方 法 如 图 4. 12 所 示 。 
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Tine | | pid | tag | Message a 
06-07 00:33:43.700 D 656 dalvikun GC freed 2807 objects / 172736 bytes in 297ns 
06-07 00:33:48.653 D 612  dalvikvm GC freed 3111 objects / 189488 bytes in 228ns 
06-07 00:34:01.919 I 570 ActivityManager Starting activity: Intent { action-android inte 
06-07 00:34:02.000 V 714  LOGCAT Verbose 

06-07 00:34:02.000 D 714 LOGCAT Debug 

06-07 00:34:02.000 I 714 LOGCAT Info 

06-07 00:34:02.000 W 714  LOGCAT Varn 

06-07 00:34:02.000 E 714 LOGCAT Error 

06-07 00:34:02.216 W 612  IInputConnectionV shovStatusIcon on inactive InputConnection 

06-07 00:34:02.251 I 570 ActivityManager Displayed activity edu hrbeu.LogCat/.LogCat: 32.) 
06-07 00:34:07.482 D 612  dalvikvn GC freed 1842 objects / 98152 bytes in 208ns Mi 


E El 


图 4.11 LogCat 工程 的 运行 结果 


Log Filter 


Filter Name: |LogcatFilter 


图 4.12 LogCat 过 滤器 


过 滤器 设置 好 后 ,LogcatFilter 过 滤 后 的 日 志 信 息 如 图 4. 13 所 示 。 在 这 之 后 ,无 论 
什么 类 型 的 日 志 信 息 ,属于 哪 一 个 进程 ,只 要 标签 为 LOGCAT ,都 将 显示 在 LogcatFilter 
区 域内 。 


LogeatFilter | 


E? assage 

LOGCAT Verbose 

LOGCAT Debug 

LOGCAT Info 

LOGCAT Varn 

LOGCAT Error 
|| EI 


图 4.13 LogCat 过 滤 后 的 输入 结果 
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在 Android 模拟 器 中 ,内置 了 一 个 用 于 调试 和 测试 的 工具 DevTools。DevTools 包 
括 了 一 系列 用 户 各 种 用 途 的 小 工具 ,包括 Development Settings, Exception Browser, 
Google Login Service, Instrumentation, Media Scanner, Package Browser, Pointer 
Location, Raw Image Viewer, Running processes 和 Terminal Emulator, K| 4. 14 是 
DevTools 的 使 用 界面 。 

在 这 些 工 具 中 ,经 常用 到 的 有 设置 调试 选项 的 Development Settings, 浏 览 已 经 安装 
程序 包 的 Package Browser, ff zz fih f à f EE HJ Pointer Location ,查看 当前 运行 进程 的 
Running processes ,还 有 连接 底层 Linux 操作 系统 的 虚拟 终端 软件 Terminal Emulator. 
后 面 的 内 容 将 逐一 地 介绍 这 些 经 常 使 用 到 小 工具 的 功能 和 使 用 方法 。 
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1. Development Settings 


Development Settings 中 包含 了 程序 调试 的 相关 选项 ,如 图 4.15 所 示 。 


ActivityLifeCy. Alarm Clock Browser 


ag 


Camcorder Camera Contacts 


Bow 


DevTools ^ Dialer Email 


HelloAndroid 。 LogCat ` Messaging 


[afl G 7:08 AM 
Development Settings 


Exception Browser 


v running processes 


Google Login Service 
Instrumentation ommum 


Media Scanner 


Package Browser 


Pointer Location 


4.14 Package Browser 4.15 Development Settings 


如 果 和 希望 启动 Development Settings 中 某 项 功能 ,只 需要 单 击 功能 前 面 选 择 框 , 出 现 
绿色 的 “对 号 ?表示 功能 启用 。 而 且 功 能 启用 后 ,模拟 器 会 自动 保存 设置 ,即使 再 次 启动 


模拟 器 用 户 的 选择 内 容 仍 会 存在 。 
表 4. 3。 


Development Settings 每 一 项 的 具体 说 明 可 以 参考 


表 4.3 Development Settings 选项 


说 — 有明 


Debug App 


为 Wait for debugger 选项 指定 应 用 程序 ,如 果 不 指 定 ( 选 择 
none), Wait for debugger 选项 将 适用 于 所 有 应 用 程序 。 
Debug App 可 以 有 效 地 防止 Android 程序 长 时 间 停 留 在 断 点 
而 产生 异常 


Wait for debugger 


阻塞 加 载 应 用 程序 ,直到 关联 到 调试 器 (Debugger)。 用 于 在 
Activity 的 onCreate( ) 函 数 进行 断 点 调试 


Show running processs 


在 屏幕 右上 角 显 示 运 行 中 的 进 


Show screen updates 


选中 该 选项 时 ,界面 上 任何 被 重 绘 的 矩形 区 域 会 闪现 粉红 
色 , 有 利于 发 现 界面 中 不 必要 的 重 绘 区 域 


No App Process limit 


允许 同时 运行 进程 的 数量 上 限 


Immediately destroy activites 


Activity 进入 停止 状态 后 立即 销毁 ,用 于 测试 在 函数 
onSavelnstanceState( .onRestoreInstanceState() 和 onCreate( ) 中 


的 代码 


Show CPU usage 


在 屏幕 顶端 显示 CPU 使 用 率 . 上 层 红 线 显示 总 的 CPU 使 用 
率 , 下 层 绿 线 显示 当前 进程 的 CPU 使 用 率 


Show background 


应 用 程序 没有 Activity 显示 时 ,直接 显示 背景 面板 ,一 般 这 种 


情况 仅 在 调试 时 出 现 
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选 项 说 明 
Show Sleep state on LED 在 休眠 状态 下 开启 LED 


Windows Animation Scale 


Transition Animation 


Light Hinting 


Show GTalk service connection status | 显示 GTalk 服务 连接 状态 


2. Package Browser 


Package Browser 是 Android 系统 中 的 程序 包 查 看 工具 ,能 够 详细 显示 已 经 安装 到 
Android 系统 中 的 程序 信息 ,包括 包 名 称 、 应 用 程序 名 称 、 图 标 、 进 程 、 用 户 ID、 版 本 、apk 
文件 保存 位 置 和 数据 文件 保存 位 置 等 ,而 且 能 够 进一步 查看 应 用 程序 所 包含 的 Activity、 
Service, BroadcastReceiver 和 Provider 的 详细 信息 。 图 4. 16 是 Package Browser 查看 
ActivityLifeCycle 程序 的 相关 信息 。 


3. Pointer Location 


Pointer Location 是 屏幕 点 位 置 查看 工具 ,能 够 显示 和 触摸 点 的 X 轴 坐标 和 立轴 坐标 。 
图 4. 17 是 Pointer Location 的 使 用 画面 。 


ActivityLifecycle 


图 4.16 Package Browser 图 4.17 Pointer Location 


4. Running processes 


Running processes 能 够 查看 在 Android 系统 中 正在 运行 的 进程 ,并 能 查看 进程 的 详 
细 信 息 ,包括 进程 名 称 和 进程 所 调用 的 程序 包 。 图 4. 18 是 Andoird 模拟 器 默认 情况 下 
运行 的 进程 和 com. android. phone 进程 的 详细 信息 。 
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5. Terminal Emulator 


Terminal Emulator 可 以 打开 一 个 连接 底层 Linux 系统 的 虚拟 终端 ,但 具有 的 权限 
较 低 , 且 不 支持 提升 权限 的 su 命令 。 如 果 需 要 使 用 root 权限 的 命令 ,可 以 使 用 ADB T. 
具 。 图 4.19 是 Terminal Emulator 运行 时 的 画面 ,输入 1s 命令 ,显示 出 根 目 录 下 的 所 有 
文件 夹 。 


DME 6:42AM 
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android.process.acore 


com.android.development 


com.android.inputmethod.latin 


com.android.phone 


system 


4.18 Running processes 图 4. 19 Terminal Emulator 
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1. 简 述 Android 系统 前 台 进 程 . 可 见 进程 .服务 进程 .后 台 进 程 和 空 进程 的 优先 级 排 
序 原因 。 

2. 简 述 Android 系统 的 4 种 基本 组 件 Activity, Service, BroadcaseReceiver 和 
ContentProvider 的 用 途 。 

3. 简 述 Activity 生命 周期 的 4 种 状态 ,以 及 状态 之 间 的 变换 关系 。 

4. 简 述 Activity 事件 回调 函数 的 作用 和 调用 顺序 。 


LE e ^ o 
Android 用 户 界 面 


用 户 界 面 是 应 用 程序 开发 的 重要 组 成 部 分 ,决定 了 应 用 程序 是 否 美观 `. 易 用 。 通 过 
本 章 的 学 习 可 以 让 读者 熟悉 Android 用 户 界面 的 基本 开发 方法 ,了 解 在 Android 界面 开 
发 过 程 中 常见 的 界面 控件 .界面 布局 .菜单 和 界面 事件 的 使 用 方法 ,充分 理解 手机 应 用 程 
序 与 桌面 应 用 程序 在 用 户 界 面 开 发 上 的 不 同 与 相同 之 处 。 

本 章 学 习 目标 : 

。 了 解 各 种 用 户 界面 的 控件 的 使 用 方法 

。 掌握 各 种 界面 布局 的 特点 和 使 用 方法 

。 掌握 选项 菜单 . 子 莱 单 和 快捷 菜单 的 使 用 方法 

。 掌握 按键 事件 和 触摸 事件 的 处 理 方法 
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用 户 界 面 (User Interface,UI) 是 系统 和 用 户 之 间 进 行 信息 交换 的 媒介 ,实现 信息 的 
内 部 形式 与 人 类 可 以 接受 形式 之 间 的 转换 。 最 古老 的 用 户 界 面 是 各 种 形式 的 文字 、 图 
FE .旗帜 和 手势 等 ,这 些 抽 象 符号 作为 信息 传递 的 介质 ,是 人 类 可 以 理解 这 些 信 息 所 包含 
的 意义 或 指 代 的 实体 。 

算盘 是 由 珠子 组 成 的 最 早 的 人 机 交互 界面 。 在 计算 机 出 现 的 早期 , 批 处 理 界面 
(1945 一 1968) 和 命令 行 界 面 (1969 一 1983) 得 到 广泛 的 使 用 。 目 前 ,流行 的 用 户 界 面 是 图 
像 用 户 界 面 (Graphical User Interface. GUD ,采用 图 形 方式 与 用 户 进行 交互 。 与 早期 的 
交互 界面 相 比 ,图 形 界面 对 于 用 户 来 说 更 加 简便 易 用 ,用 户 从 此 不 再 需要 记 住 大 量 的 命 
令 , 取 而 代 之 的 是 通过 窗口 .菜单 和 按钮 等 方式 来 进行 操作 。 未 来 的 用 户 界 面 将 更 多 地 
运用 虚拟 现实 技术 ,使 用 户 能 够 摆脱 键盘 与 鼠标 的 交互 方式 ,而 通过 动作 、 语 言 ,甚至 是 
脑 电 波 来 控制 计算 机 。 当 然 , 对 用 户 界面 的 深入 探讨 远 超 出 了 本 书 的 涉及 范围 , 感 兴 
的 读者 可 以 阅读 相关 方面 的 书籍 。 

在 手机 上 进行 用 户 界面 设计 是 一 项 具体 挑战 性 的 工作 。 首 先 ,手机 界面 的 设计 者 和 
程序 开发 人 员 一 般 是 独立 且 并 行 工作 的 ,这 就 需要 界面 设计 与 程序 逻辑 完全 分 离 ,这样 
不 仅 有 利于 并 行 开 发 ,而 且 在 后 期 修改 界面 时 ,也 不 用 再 次 修改 程序 的 逻辑 代码 ;其 次 ， 
不 同型 号 手机 的 屏幕 解析 度 、 尺 寸 和 纵横 比 各 不 相同 ,用 户 界面 需要 能 够 根据 屏幕 信息 ， 
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自动 调整 界面 上 部 分 控件 的 位 置 和 尺寸 ,避免 因为 屏幕 解析 度 、 尺 寸 或 纵横 比 的 变化 而 
出 现 显示 错误 ;最 后 ,手机 屏幕 尺寸 较 小 .设计 者 必须 能 够 合理 利用 有 限 的 显示 空间 , 构 
造 出 符合 人 机 交互 规律 的 用 户 界 面 , 避 免 出 现 凌 乱 .拥挤 的 用 户 界面 。 

Android 系统 已 经 为 使 用 者 解决 了 界面 设计 前 两 个 问题 。 在 界面 设计 与 程序 逻辑 分 
离 方面 ,Android 程序 将 用 户 界 面 和 资源 从 逻辑 代码 中 分 离 出 来 ,使 用 XML 文件 对 用 户 
界面 进行 描述 ,资源 文件 独立 保存 在 资源 文件 夹 中 。Android 系统 的 界 用 户 面 描述 非常 
灵活 ,允许 不 明确 定义 界面 元 素 的 位 置 和 尺寸 , 仅 声 明 界 面 元 素 的 相对 位 置 和 粗略 尺寸 ， 
从 而 使 界面 元 素 能 够 根据 屏幕 尺寸 和 屏幕 摆 放 方式 动态 调整 显示 方式 。 

Android 用 户 界 面 框架 (Android UI Framework ) 采用 MVC ( Model-View- 
Controller) 模 型 ,如 图 5. 1 所 示 。MVC 模型 为 用 户 界面 提供 了 处 理 用 户 输入 的 控制 器 
(Controller) ,显示 用 户 界面 和 图 像 的 视图 (View) ,以 及 保存 数据 和 代码 的 模型 (Model) 。 

MVC 模型 中 的 视图 将 应 用 程序 的 信息 反馈 给 用 户 , 可 能 的 反馈 方法 包括 视觉 .听觉 
或 触觉 等 ,但 最 常用 的 就 是 通过 屏幕 显示 反馈 信息 。Android 用 户 界 面 框架 中 的 界面 元 
素 以 一 种 树 形 结构 组 织 在 一 起 , 称 为 视图 树 (View Tree) ,如 图 5. 2 所 示 。Android 系统 
在 屏幕 上 绘制 界面 元 素 时 ,会 依据 视图 树 的 结构 从 上 至 下 绘制 每 一 个 界面 元 素 。 每 个 元 
素 负责 对 自身 的 绘制 ,如 果 元 素 包 含 子 元 素 , 该 元 素 会 通知 其 下 所 有 子 元 素 进行 绘制 。 
Android 系统 在 用 户 界面 绘制 上 还 有 着 一 些 提 高 效率 的 方法 ,例如 如 果 父 元 素 能 够 确定 
某 个 区 域 一 定 会 被 其 子 元 素 绘制 , 则 父 元 素 会 停止 绘制 该 区 域 ,以 提高 屏幕 绘制 的 效率 ， 
缩短 绘制 时 间 。 


键盘 等 输入 


控制 器 ViewGroup 
| 
View ViewGroup View 
绘制 界 画 更 新 
模型 


View View View 


> 


图 5.1 MVC 模型 图 5.2 视图 树 


视图 树 由 View 和 ViewGroup 构成 。View 是 界面 的 最 基本 的 可 视 单 元 ,存储 了 屏 
幕 上 特定 矩形 区 域内 所 显示 内 容 的 数据 结构 ,并 能 够 实现 所 占据 区 域 的 界面 绘制 、 焦 点 
变化 .用户 输入 和 界面 事件 处 理 等 功能 。View 也 是 一 个 重要 的 基 类 ,所 有 在 界面 上 的 可 
见 元 素 都 是 View 的 子 类 。ViewGroup 是 一 种 能 够 承载 含 多 个 View 的 显示 单元 ,一 般 
有 两 个 用 途 ,一 个 是 承载 界面 布局 , 另 一 个 是 承载 具有 原子 特性 的 重 构 模 块 。 

MVC 模型 中 的 控制 器 能 够 接受 并 响应 程序 的 外 部 动作 ,如 按键 动作 或 触摸 屏 动 作 
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等 。 控 制 器 使 用 队列 处 理 外 部 动作 ,每 个 外 部 动作 作为 一 个 对 立 的 事件 被 加 入 队列 中 ， 
然后 Android 用 户 界面 框架 按照 “先进 先 出 ?的 规则 从 队列 中 获取 事件 ,并 将 这 个 事件 分 
配给 所 对 应 的 事件 处 理 函 数 。 

Android 用 户 界 面 框架 中 另 一 个 重要 的 概念 就 是 单线 程 用 户 界面 (Single-threaded 
UD, 。 在 单线 程 用 户 界面 中 ,控制 器 从 队列 中 获取 事件 和 视图 在 屏幕 上 绘制 用 户 界 面 ,使 
用 的 都 是 同一 个 线程 。 单 线程 用 户 界面 能 够 降低 应 用 程序 的 复杂 程度 ,同时 也 能 降低 开 
发 的 难度 。 首 先 ,用 户 不 需要 在 控制 器 和 视图 之 间 进 行 同步 。 其 次 ,所 有 事件 处 理 完全 
按照 其 加 入 队列 的 顺序 进行 ,也 就 是 说 ,在 事件 处 理 函 数 返 回 前 不 会 处 理 其 他 的 事件 , 因 
此 用 户 界 面 的 事件 处 理 函 数 具 有 原子 性 。 但 单线 程 用 户 界面 也 有 它 的 缺点 ,如 果 事 件 处 
理 函 数 过 于 复杂 ,可 能 会 导致 用 户 界面 失去 响应 。 因 此 尽 可 能 在 事件 处 理 函数 中 使 用 简 
短 的 代码 ,或 将 复杂 的 工作 交 给 后 台 线 程 处 理 。 


52 界面 控件 


Android 系统 的 界面 控件 分 为 定制 控件 和 系统 控件 。 定 制 控 件 是 用 户 独 立 开发 的 控 
件 ,或 通过 继承 并 修改 系统 控件 后 所 产生 的 新 控件 ,能 够 为 用 户 提供 特殊 的 功能 或 与 众 
不 同 的 显示 需求 方式 。 系 统 控件 Android 系统 提供 给 用 户 已 经 封装 的 界面 控件 ,提供 在 
应 用 程序 开发 过 程 中 常见 功能 控件 。 系 统 控 件 更 有 利于 帮助 用 户 进 行 快速 开发 ,同时 能 
够 使 Android 系统 中 应 用 程序 的 界面 保持 一 致 性 。 

常见 的 系统 控件 包括 Text View, EditText, Button, ImageButton, CheckBox, 
RadioButton „Spinner, ListView 和 TabHost. 


521 TetMew 和 EditTet 


Text View 是 一 种 用 于 显示 字符 串 的 控件 ,EditText 则 是 用 来 输入 和 编辑 字符 串 的 
控件 , 因为 EditText 继承 于 TextView, 所 以 EditText 是 一 个 具有 编辑 功能 的 
TextView。TextViewDemo 是 一 个 同时 具有 TextView 和 
EditText 的 示例 ,如 图 5. 3 所 示 , 上 方 “ 用 户 名 ”部 分 使 用 
的 是 TextView, 下 方 的 文字 输入 框 使 用 的 是 EditText。 

TextView 和 EditText 控件 的 命名 分 别 是 
TextView01 和 EditText01 ,在 XML 文件 中 (/res/layout/ 
main. xml) 中 的 代码 如 下 : 图 5.3 TextView 和 EditText 
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< TextView android: id= "@ + id/TextView01" 
android: layout_width= "wrap content" 
android: layout height= "wrap content" 
android:text- "TextView01"> 

< /TextView> 

<EditText android:id- "@ + id/EditText01" 
android: layout_width= "fill parent" 
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8 android:layout beight- "wrap content" 

9 android:text- "EditText01"> 

10 < /EditText> 

第 1 47 android; id 属性 声明 了 Text View 的 ID, 这 个 ID 主要 用 于 在 代码 中 引用 这 个 
TextView 对 象 。“@ 十 id/TextView01” 表 示 所 设置 的 了 D 值 ,其 中 @ 表 示 后 面 的 字符 串 
是 ID 资源 ;加 号 (十 ) 表 示 需 要 建立 新 资源 名 称 , 并 添加 到 R. java 文件 中 ; 斜 杠 后 面 的 字 
符 串 (TextView01) 表 示 新 资源 的 名 称 。 如 果 属 于 不 是 新 添加 的 ,或 属于 Android 框架 的 
ID 资源 , 则 不 需要 使 用 加 号 (十 ), 但 必须 添加 Android 包 的 命名 空间 ,例如 android: 
id="@android:id/empty" 。 

第 2 行 的 android:layout_width 属性 用 来 设置 TextView 的 宽度 ,wrap_content 表 
示 TextView 的 宽度 只 要 能 够 包含 所 显示 的 字符 串 即 可 。 第 3 行 的 android: layout_ 
height 属性 用 来 设置 TextView 的 高 度 。 第 4 行 表示 TextView 所 显示 的 字符 串 ,在 后 面 
将 通过 代码 更 改 TextView 的 显示 内 容 。 第 7 行 中 fill_content 表示 EditText 的 宽度 将 
等 于 父 控 件 的 宽度 。 

TextViewDemo. java 文件 中 ,引用 XML 文件 中 建立 的 TextView 和 EditText, 并 更 
改 其 显示 内 容 。 为 了 能 够 使 程序 正常 运行 ,需要 在 代码 中 引入 android. widget. EditText 
和 android. widget. TextView, 


TextView textView- (TextView) findViewById (R.id.TextView0l) ; 
EditText editText- (EditText) findViewByld (R.id.EditText0l) ; 
textView.setText "H P! 4% : "); 

editText .set'Text ("") ; 


第 1 行 的 findViewById O &R RAE 388 zb ID 引用 界面 上 的 任何 控件 ,只 要 该 控件 在 
XML 文件 中 定义 过 ID 即 可 。 第 3 行 的 setText () 函 数 用 来 设置 TextView 所 显示 的 内 容 。 
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Button 是 一 种 按钮 控件 ,用 户 能 够 在 该 控件 上 点 击 , 并 后 引发 相应 的 事件 处 理 函 数 。 
很 多 情况 下 ,用 户 需 要 一 个 能 够 显示 图 像 的 按钮 ,Android 系统 提供 了 ImageButton f 
件 , 用 以 实现 能 够 显示 图 像 功 能 的 按钮 。ButtonDemo 是 一 个 简单 的 按钮 示例 ,如 图 5. 4 
所 示 ,上方 的 “Button 按钮 ?是 一 个 Button 控件 ,下 方 的 按钮 是 一 个 ImageButton 控件 。 

ButtonDemo 示例 从 上 至 下 的 控件 ID 分 别 是 TextView01、Button01 和 
ImageButton01。 在 XML 文件 中 (/res/layout/main. xml) 的 代码 如 下 : 


Wn ro 


< /Button> 
< ImageButton android:id- "@ + id/ImageButton01" 
android:layout width- "wrap content" 


5.4 Button 和 ImageButton 


1 — «Button android:id- "@ + id/Button01" 
2 android:layout width- "wrap content" 

3 android:layout height- "wrap content" 
4 android:text- "Button01"> E3 

5 

6 

d 


8 android:layout height- "wrap content"> 

9 < /TmageButton> 

XML 文件 中 定义 了 两 个 按钮 的 宽度 和 高 
度 ,并 定义 了 Button 控件 所 显示 的 内 容 , 但 没有 
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New 


定义 ImageButton 所 显示 的 图 像 ,所 显示 的 图 像 
在 后 面 的 代码 中 进行 定义 。 

Android 系统 支持 多 中 图 形 格式 ,例如 png. 
ico 等 等 ,本 例 中 使 用 png 文件 作为 ImageButton 
的 显示 图 像 。 首先 将 download. png 文件 拷贝 
到 /res/drawable 文件 夹 下 ,然后 在 /res 目录 上 选 
择 Refresh( 见 图 5.5), 刷 新 后 新 添加 的 文件 将 显 
示 在 /res/drawable 文件 夹 下 ,同时 R. java 文件 
内 容 也 得 到 了 更 新 ,否则 无 法 在 代码 中 使 用 该 资 
源 , 会 提示 无 法 找到 资源 的 错误 。 

ButtonDemo. java 文件 中 ,引用 XML 文件 
中 建立 的 Button 和 ImageButton, 更 改 Button 的 
显示 字符 内 容 和 ImageButton 图 像 内 容 。 为 了 能 
够 使 程序 正常 运行 ,需要 在 代码 中 引入 android. 


widget. Button 和 android. widget. ImageButton, 


button.setText ("Button fi EH ") ; 
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5.5 BHR. java 文件 


Button button= (Button) findViewByld (R.id.Button01) ; 
TmageButton imageButton= (ImageButton) findViewByld (R. id. ImageButton01) ; 


imageBut ton . set ImageResource (R.drawable download) ; 


第 1 行 和 第 2 行 代码 用 于 引用 在 XML 文件 中 定义 的 Button 控件 和 ImageButton 


控件 。 第 3 行 代码 将 Button 的 显示 内 容 更 改 为 "Button 按钮 >。 第 4 行 代码 利用 
setImageResource ( ) 函数 ,将 新 加 入 的 png 文件 R. drawable. download 传递 给 


ImageButton, 


为 了 能 够 使 按钮 响应 点 击 事件 ,在 onCreateO 函数 中 为 Button 控件 和 ImageButton 


控件 添加 点 击 事件 的 监听 器 ,代码 如 下 : 


1 final TextView textView= (TextView) findViewBylId (R.id.TextView0l) ; 
2 button.setOnClickListener (new View.OnClickListener() { 

3 public void onClick (View view) { 

4 textView.setText ("Button f £l ") ; 

5 i 

6 n; 

7 imageButton.setOnClickListener (new View.OnClickListener() { 

8 public void onClick (View view) { 

9 textView.setText ("ImageButton fi EH ") ; 
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在 第 2 行 代码 中 ,button 对 象 通过 调用 setOnClickListener() PR C. E D rb 
(CClick) 事 件 的 监听 器 View. OnClickListener()。 第 3 行 代码 是 点 击 事件 的 回调 函数 。 
第 4 行 代码 将 TextView 的 显示 内 容 更 改 为 "Button 按钮 ”。 

View. OnClickListener() 是 View 定义 的 点 击 事件 的 监听 器 接口 ,并 在 接口 中 仅 定 
X f onClickO PR, 4 Button 从 Android 界面 框架 中 接收 到 事件 后 ,首先 检查 这 个 事 
件 是 否 是 点 击 事件 ,如 果 是 点 击 事件 ,同时 Button 又 注册 了 监听 器 , 则 会 调用 该 监听 器 中 
的 onClick O 函数 。 

每 个 View 仅 可 以 注册 一 个 点 击 事件 的 监听 器 ,如果 使 用 setOnClickListener() 函数 
注册 第 二 个 点 击 事件 的 监听 器 ,之 前 注册 的 监听 器 将 被 自动 注销 。 给 每 个 按钮 注册 一 个 
点 击 事件 监听 器 ,每 个 按钮 的 事件 处 理 程序 都 在 各 自 的 onClick() 函 数 , 这 样 能 够 使 代码 
更 加 清晰 、 易 读 , 且 易于 维护 。 当 然 , 也 可 以 将 多 个 按钮 注册 到 同一 个 点 击 事件 的 监听 器 
上 ,示例 代码 如 下 : 


1 Button.OnClickListener buttonListener= new Button.OnClickListener () { 
2 @ Override 

3 public void onClick (View v) { 

4 switch (v.getId()) ( 

5 case R.id.Button0l: 

6 textView.setText ("Button f£ £l ") ; 

7 return; 

8 case R.id. ImageButton01: 

9 textView.setText ("ImageButton f% EH mi ; 
10 retum; 

11 } 

12 H; 

13 button.setOnClickListener (buttonListener) ; 

14 imageButton.setOnClickListener (buttonListener) ; 


第 1 行 至 第 12 行 代码 定义 了 一 个 名 为 buttonListener 的 点 击 事件 监听 器 ,第 13 行 
和 第 14 行 代码 分 别 将 给 该 监听 器 注册 到 Button 和 ImageButton LE. 
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CheckBox 是 一 个 同时 可 以 选择 多 个 选项 的 控件 ,而 RadioButton 则 是 仅 可 以 选择 一 
个 选项 的 控件 。RadioGroup 是 RadioButton 的 承载 体 , 程 序 运 行 时 不 可 见 , 应 用 程序 中 
可 能 包含 一 个 或 多 个 RadioGroup。 RadioGroup 包含 多 个 RadioButton, 在 一 个 
RadioGroup 中 ,用户 仅 能 够 选择 其 中 一 个 RadioButton。 在 图 5.6 中 ,RadioGroup 中 包 
含 两 个 RadioButton ,当选 择 Radio Buttonl 后 ,RadioButton2 自动 变 为 非 选 择 状 态 。 

CheckboxRadiobuttonDemo 示例 从 上 至 下 的 控件 ID 分 别 是 TextView01、 
CheckBox01、CheckBox02、RadioButton01 和 RadioButton02。 在 XML 文件 中 (/res/ 


layout/main. xml) 的 代码 如 下 : 
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< TextView android:id- "@ + id/TextView01" 
android:layout width- "fill parent" 
android:layout height- "wrap content" [ T 
android:text- "@ string/hello"/» 
< CheckBox android: id= "@ + id/CheckBox01" Med 
android:layout width- "wrap content" Qoo 
android:layout height- "wrap content" 
android:text- "CheckBox01"> 
< /CheckBox> 
< CheckBox android:id- "@ + id/CheckBox02" 
android:layout_width= "wrap content" 
android:layout_height= "wrap content" 
android:text- "CheckBox02"> 
< /CheckBox> 
< RadioGroup android: id= "@ + id/RadioGroupOl" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content"> 
< RadioButton android:id- "@ + id/RadicButton01" 
android: layout_width= "wrap content" 
android: layout_height= "wrap content" 
android: text= "RadicButton01"> 
< /RadicButton> 
< RadioButton android: id= "@ + id/RadioButton02" 
android: layout_width= "wrap content" 
android: layout_height= "wrap content" 
android:text- "RadioButton02"» 
< /RadicButton> 
< /RadioGroup> 


5.6 CheckBox 和 RadioButton 


第 15 行 二 RadioGroup 二 标签 声明 了 一 个 RadioGroup ,在 第 18 行 和 第 23 行 分 别 声 
明了 两 个 RadioButton ,这 两 个 RadioButton 是 RadioGroup 的 子 元 素 。 
在 代码 中 引用 CheckBox 和 RadioButton 的 方法 可 以 参考 下 面 的 代码 : 


1 
2 


CheckBox checkBoxl- (CheckBox) findViewById (R.id.CheckBox01) ; 
RadioButton radicButtonl- (RadioButton) findViewById (R.id.RadicButton01) ; 


CheckBox 设置 点 击 事件 监听 器 的 方法 ,与 Button 中 介绍 的 方法 相似 ,唯一 不 同 在 
于 将 Button. OnClickListener 换 成 了 CheckBox. OnClickListener ,下 面 给 出 简要 代码 ; 
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CheckBox.OnClickListener checkboxListener= new CheckBox.OnClickListener () { 
@ Override 
public void onClick (View v) { 
// 过 程 代 码 
DH 
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6 checkBox1 .setOnClickListener (checkboxListener) ; 
7 checkBox2.setOnClickListener (checkboxLi stener) ; 


RadioButton 设置 点 击 事件 监听 器 的 方法 : 


1 RadicButton.OnClickListener radicButtonListener= new RadicButton.OnClickListener () { 
2 @ Override 

3 public void onClick (View v) { 

4 // 过 程 代码 

5 He 

6 radicButtonl.setOnClickListener (radicButtonListener); 

7 radicButton2.setOnClickListener (radicButtonListener) ; 
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Spinner 是 一 种 能 够 从 多 个 选项 中 选择 一 个 选项 的 控件 ,类 似 于 桌面 程序 的 组 合 框 
(ComboBox) ,但 没有 组 合 框 的 下 拉 菜 单 ,而 是 使 用 浮动 菜 
单 为 用 户 提供 选择 。SpinnerDemo 是 一 个 包含 3 个 子 项 的 keen 
Spinner 控件 示例 ,如 图 5. 7 所 示 。 

SpinnerDemo 示例 从 上 至 下 的 控件 ID 分 别 为 
TextView01 和 Spinner01。 在 XML 文件 (/res/layout/ 


main, xml) 中 的 代码 如 下 : Laden 
Spinner 子 项 2 
1 <TextView android:id- "@ + id/TextView01" 
2 android:layout width= "fill parent" Spinner 子 项 3 
3 android:layout height- "wrap content" 
4 android:text- "@ string/hello"/> 5.7 Spinner 
5 «Spinner android:id- "@ + id/Spinner01" 
6 android:layout width "300dip" 
7 android:layout height- "wrap content' 
8 </Spinner> 


第 5 (Tf HI — Spinner $548 H T —4* Spinner 控件 ,并 在 第 6 行 代码 中 指定 了 该 
控件 的 宽度 为 300dip。 

在 SpinnerDemo. java 文件 中 ,定义 一 个 ArrayAdapter 适配器 ,在 ArrayAdapter 中 
添加 需要 在 Spinner 中 可 以 选择 的 内 容 。 为 了 能 够 使 程序 正常 运行 ,需要 在 代码 中 引入 
android. widget. ArrayAdapter 和 android. widget. Spinner。 


Spinner spinner- (Spinner) findViewById (R.id.Spinner01) ; 
List< String> list =new ArrayList< String> (); 

list .add ("Spinner F 1"); 

list .add ("Spinner F 2"); 

list .add ("Spinner F 3"); 

ArrayAdapter< String> adapter= new ArrayAdapter< String> (this, 
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android.R.layout.simple spinner item, list); 

yi adapter. setDrqpDowrlViewResource (android.R.laycut.simple spinner dropdown item); 

8 spinner .setAdapter (adapter) ; 

第 2 行 代码 建立 了 一 个 字符 串 数组 列表 (ArrayList) ,这 种 数组 列表 可 以 根据 需要 进 
行 增 减 ,二 String 二 表示 数组 列表 中 保存 的 是 字符 串 类 型 的 数据 。 在 代码 的 第 3,4,5 行 
中 ,使 用 add() 函数 分 别 向 数组 列表 中 添加 3 个 字符 串 。 第 6 行 代码 建立 了 一 个 


ArrayAdapter 的 数组 


ame 


Spinner 子 项 1 
Spinner 子 项 2 
Spinner 子 项 3 


适配器 ,数组 适配器 能 够 将 界面 控件 和 底层 数据 绑 定 在 一 起 。 
ArrayAdapter 将 Spinner 和 ArrayList 绑 定 在 一 起 ,所 有 
ArrayList 中 的 数据 ,将 显示 在 Spinner 的 浮动 菜单 中 , 绑 
定 过 程 由 第 8 行 代码 实现 。 第 7 行 代 码 设 定 了 Spinner 的 
浮动 菜单 的 显示 方式 ,其 中 ,android. R. layout. simple _ 
spinner_dropdown_item 是 Android 系统 内 置 的 一 种 浮动 
菜单 ,如 图 5.7 所 示 。 如 果 将 其 改 为 android. R. layout. 
simple_spinner_item, 则 显示 效果 如 图 5. 8 所 示 。 

为 了 保证 用 户 界面 的 显示 内 容 与 底层 数据 的 一 致 性 ， 
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图 5.8 Spinner Bf) item 菜单 ”应 用 程序 需要 监视 底层 数据 的 变化 ,如 果 底 层 数据 更 改 了 ， 


控件 和 底层 数据 后 ,应 
的 复杂 性 。 
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则 用 户 界面 也 需要 修改 显示 内 容 。 在 使 用 适配器 绑 定 界面 
用 程序 就 不 需要 再 监视 底层 数据 的 变化 ,从 而 极 大 地 简化 了 代码 


List View 是 一 种 用 于 垂直 显示 的 列表 控件 ,如 果 显 示 内 容 过 多 , 则 会 出 现 垂 直 滚 动 


条 。ListView EER I 


而 设计 中 经 常 使 用 的 界面 控件 ,主要 是 因为 List View 能 够 通过 适 


配器 将 数据 和 自身 绑 定 , 在 有 限 的 屏幕 上 提供 大 量 内 容 供用 户 选 择 ; 而 且 支持 点 击 事件 


处 理 ,用户 可 以 用 少量 


何 使 用 ListView 的 示例 ,界面 如 图 5. 9 所 示 。 
ListViewDemo 示例 从 上 至 下 的 控件 ID 分 别 为 
TextView01 和 ListView01。 在 XML X ff (/res/layout/ 


的 代码 实现 复杂 的 选择 功能 。ListViewDemo 是 一 个 用 来 说 明 如 
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ListView 子 项 1 
main. xml) 中 的 代码 如 下 : 
ListView 子 项 2 
«TextView android:id="@ + id/TextView01" 
android: layout. width= "fill parent" ListView 子 项 3 
android:layout height- "wrap content" 


o A o Dm e Lä hä a 


< /ListView> 


android:text- "8 string/hello"/> 5.9 ListView 
< ListView android:id- "@ + id/ListView01" 

android: layout_width= "wrap content" 

android:layout height- "wrap content"» 


在 List ViewDemo. java 文件 中 ,首先 需要 为 ListView 创建 适配器 ,并 添加 List View 
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CAE EES: 


中 所 显示 的 内 容 。 


final TextView textView= (TextView) findViewById (R.id.TextView01) ; 

ListView listView- (ListView) findViewById (R.id.ListView01) ; 

List< String> list - new ArrayList< String> (); 

list.add ("ListView F 1"); 

list.add ("ListView F 2"); 

list.add ("ListView F 3"); 

ArrayAdapter< String> adapter= new ArrayAdapter< String> (this, 
android.R.layout.simple list item 1, list ); 

8 listView.setAdapter (adapter) ; 

第 2 行 代 码 通过 ID 引用 了 XML 文件 中 声明 的 ListView. 55 3 行 至 第 6 行 声 明了 
数组 列表 ,第 7 行 声 明了 适配器 ArrayAdapter, 第 三 个 参数 list 说 明 适 配器 的 数据 源 为 
数组 列表 。 第 8 行将 ListView 和 适配器 绑 定 。 

下 面 的 代码 声明 了 ListView 子 项 的 点 击 事件 监听 器 ,用 以 确定 用 户 在 List View 中 ， 
选择 的 是 哪 一 个 子 项 。 
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1 AdapterView.OnItemClickListener listViewListener- new 
pdapterView.OnItenClickistener 0 ( 

2 € Override 

3 public void onItenClick (AdapterView< ?> arg0, View argl, int arg2, long arg3) { 

4 String msg ="; 

5 textView.setText (msg) ; 

6 » 

7 listView.setOnItenClickListener (listViewListener) ; 

第 1 47) AdapterView. OnItemClickListener 是 List View 子 项 的 点 击 事件 监听 器 ， 
同样 是 一 个 接口 ,需要 实现 onltemClick C) 函数 。 在 ListView 子 项 被 选择 后 ， 
onItemClickO PR ROM BIA. 58 3 行 的 onItemClick() 函 数 中 一 共有 4 个 参数 ,参数 0 
表示 适配器 控件 ,就 是 List Views 23 1 表示 适配器 内 部 的 控件 ,是 List View 中 的 子 项 ; 
参数 2 表示 适配器 内 部 的 控件 ,也 就 是 子 项 的 位 置 :参数 3 表示 子 项 的 行 号 。 第 4 行 和 第 
5 行 代 码 用 于 显示 信息 ,选择 子 项 确定 后 ,在 Text View 中 显示 子 项 父 控件 的 信息 、 子 控 
件 信息 .位 置信 息 和 ID 信息 。 第 7 行 代码 是 List View 指定 刚刚 声明 的 监听 器 。 
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Tab 标签 页 是 界面 设计 时 经 常 使 用 的 界面 控件 ,可 以 实现 多 个 分 页 之 间 的 快速 切 
换 , 每 个 分 页 可 以 显示 不 同 的 内 容 。 图 5. 10 所 示 是 Android 系统 内 置 的 Tab 标签 页 , 单 
击 “ 呼 出 /接听 键 ? 后 出 现 ,用 于 电话 呼出 和 查看 拨号 记录 RA A. 

Tab 标签 页 的 使 用 首先 要 设计 所 有 的 分 页 的 界面 布局 ,在 分 页 设计 完成 后 ,使 用 代 
码 建立 Tab 标签 页 ,并 给 每 个 分 页 添加 标识 和 标题 ,最 后 确定 每 个 分 页 所 显示 的 界面 
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eme 

在 设计 分 页 的 界面 布局 时 ,使 用 的 方法 与 设计 普通 用 A B | Mm | * 
户 界面 没有 什么 区 别 。 为 了 便于 可 视 化 和 编码 ,为 每 个 分 So on ene 
页 建立 一 个 XML 文件 ,用 以 编辑 和 保存 分 页 的 界面 布局 。 
在 TabDemo 示例 中 ,在 /res/layout 目录 下 建立 3 个 XML 
文件 ,分 别 为 tabl. xml、tab2. xml 和 tab3. xml, 这 3 个 文件 
分 别 使 用 线性 布局 .相对 布局 和 绝对 布局 示例 中 的 main. 
xml 的 代码 ,并 将 布局 的 ID 分 别 定义 为 layout01、layout02 
和 layout03。 下 面 分 别 给 出 tabl. xml, tab2. xml 和 tab3. ate 
xml 文件 的 部 分 代码 。 

tabl. xml 文件 代码 如 下 : 


1 <?xml version= "1.0"encoding= "utf- 8"?» 

2 <Linearlayout android:id="@ + id/layout0l" 
4 t 

5 

6 < /LinearLayout> 

tab2. xml 文件 代码 如 下 : 

1 <?xml version= "1.0"encoding= "utf- 8"?> 

2 <AbsoluteLayout android: id= "@ + id/layout02" 
3 I 

4 

5 < /AbsoluteLayout> 


tab3. xml 文件 代码 如 下 ; 
1 <?xml version= "1.0"encoding= "utf- 8"?> 

2 < Relativelayout android:id- "@ + id/layout03" 
3 I 

4 

5 < /RelativeLayout> 


分 页 的 布局 代码 设计 完成 后 ,在 TabDemo. java 文件 中 输入 下 面 的 代码 ,创建 Tab 
标签 页 ,并 建立 子 页 与 界面 布局 直接 的 关联 关系 。 

1 package edu.hrbeu.Tabpemp; 

2 

3 import android.app.TabActivity; 

4 import android.os.Bundle; 

5 import android.widget .TabHost; 

6 import android.view.LayoutInflater; 
vi 
8 


public class TabDamo extends TabActivity { 
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人 six 


14 


15 


23 


} 


@ Override 
public void onCreate (Bundle savedInstanceState) { 


Super .onCreate (savedInstanceState) ; 
TabHost tabHost- getTabHost () ; 
IayoutInflater.fram(this) .inflate (R.layout.tabl, 
tabHost.getTabContentView () , true) ; 
IayoutInflater.fram(this) .inflate (R. layout.tab2, 
tabHost .getTabContentView () true) ; 
IayoutInflater.fram(this) .inflate (R. layout .tab3, 
tabHost.getTabContentView () , true) ; 
tabHost .addTab (tabHost.newTabSpec ("TABL") 
«set Indicator ("£X HE ffi Jay") .setContent (R.id.layout01) ) ; 
tabHost .addTab (tabHost .newTabSpec ("TAB2") 
-set Indicator ("fi X} ffi Jay ") .setContent (R.id. layout02) ) ; 
tabHost .addTab (tabHost .newTabSpec ("TAB3") 
-set Indicator ("相对 布局 ") -setContent (R.id.layout03)); 


第 8 行 代 码 的 声明 TabDemo 类 继承 于 TabActivity. 与 以 往 继承 Activity 不 同 ， 
TabActivity X EVI ZA Activity 或 View。 第 12 行 代码 通过 getTabHost O PR BAR 
了 Tab 标签 页 的 容器 ,用 以 承载 可 以 点 击 的 Tab 标签 和 分 页 的 界面 布局 。 第 13 行 代码 
通过 LayoutInflater 将 tabl. xml 文件 中 的 布局 转换 为 Tab 标签 页 可 以 使 用 的 View 对 
象 。 第 16 行 代码 使 用 addTab CO PG BCE IN ri 个 分 页 , tabHost. newTabSpec 
("TAB1") 表 明 在 第 12 行 代码 中 建立 的 tabHost 上 ,添加 一 个 标识 为 TAB1 的 Tab 分 
页 。 第 17 行 代 码 使 用 setIndicator() 郴 数 设 定 分 页 显示 的 标题 ,使 用 setContent O PR Zt 
设 定 分 页 所 关联 的 界面 布局 。TabDemo 示例 的 运行 结果 如 图 5. 11 所 示 。 
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(a)“ 线 性 布局 ”分 页 (b)“ 绝 对 布局 ”分 页 


图 5.11 TabDemo 示例 的 运行 结果 


在 使 用 Tab 标签 页 时 ,可 以 将 不 同 分 页 的 界面 布局 保存 在 不 同 的 XML 文件 中 ,也 
可 以 将 所 有 分 页 的 布局 保存 在 同一 个 XML 文件 中 。 前 一 种 方法 有 利于 在 Eclipse 开发 
环境 中 进行 可 视 化 设计 ,并 且 不 同 分 页 的 界面 布局 在 不 同 的 文件 中 更 加 易于 管理 ,而 后 
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一 种 方法 则 可 以 产生 较 少 的 XML 文件 ,同时 编码 时 的 代码 也 会 更 加 简洁 。 
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界面 布局 (Layout) 是 用 户 界面 结构 的 描述 ,定义 了 界面 中 所 有 的 元 素 、 结 构 和 相互 
关系 。 一 般 声 明 Android 程序 的 界面 布局 有 两 种 方法 ,第 一 种 是 使 用 XML 文件 描述 界 
面 布局 , 另 一 种 是 在 程序 运行 时 动态 添加 或 修改 界面 布局 。 

Android 系统 提供 了 在 声明 界面 布局 上 提供 了 很 好 的 灵活 性 ,用 户 既 可 以 独立 使 用 
任何 一 种 声明 界面 布局 的 方式 ,也 可 以 同时 使 用 两 种 方式 。 一 般 情况 下 ,XML 文件 用 来 
描述 用 户 界 面 中 最 基本 的 元 素 , 而 在 代码 中 动态 修改 需要 更 新 状态 的 界面 元 素 。 当 然 ， 
用 户 也 可 以 在 将 所 有 的 界面 元 素 , 无 论 在 程序 运行 后 是 否 需要 修改 其 内 容 , 都 放 在 代码 
中 进行 定义 和 声明 。 很 明显 这 不 是 一 种 好 的 设计 方式 ,会 给 后 期 界面 修改 带 来 不 必要 的 
麻烦 ,而且 界 面 元 素 较 多 时 ,程序 的 代码 也 会 显得 混乱 不 堪 。 

使 用 XML 文件 声明 界面 布局 ， pr gree eh 和 控制 层 分 离 ,在 后 期 修 
改 用 户 界面 时 ,无 需 更 改 程序 的 源 代码 。 例 如 ,在 程序 开发 完成 后 ,为 了 让 程序 能 够 支持 
ere luc rope wg rae dt ei aban 
不 仅 如 此 ,使 用 XML 文件 声明 的 界面 布局 ,用 户 还 能 够 通过 可 视 化 工具 直接 看 到 所 设计 
的 用 户 界面 ,有 利于 加 快 界面 设计 的 过 程 ,并 且 为 界面 设计 与 开发 带 来 极 大 的 便利 性 。 
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线性 布局 (LinearLayout) 是 一 种 重要 的 界面 布局 ,也 是 经 常 使 用 到 的 一 种 界面 布局 。 
在 线性 布局 中 ,所 有 的 子 元 素 都 按照 垂直 或 水 平 的 顺序 在 界面 上 拓 列 。 如 果 垂 直 排列 ， 
则 每 行 仅 包含 一 个 界面 元 素 ; 同 样 ,如 果 水 平 排列 , 则 每 列 仅 包含 一 个 界面 元 素 。 图 5. 12 
分 别 是 垂直 排列 的 线性 布局 和 水 平 排列 的 线性 布局 的 示例 。 


(a) 垂直 排列 (b) 水 平 排列 
图 5.12 线性 布局 


下 面 将 用 一 个 简单 的 示例 说 明 如 何 使 用 线性 布局 ,示例 的 目标 是 实现 图 5. 13 所 显 
示 的 用 户 界 面 ,并 对 示例 中 用 到 的 界面 控件 进行 简单 的 介绍 。 
首先 创建 Android T. f£. 工程 名 称 是 LinearLayout, 包 名 称 是 edu. hrbeu. 
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LinearLayout, Activity 名 称 为 LinearLayout。 为 了 能 够 完整 体验 创建 线性 布局 的 过 程 ， 
首先 删除 Eclipse 自动 建立 的 /res/layout/main. xml 文件 ,然后 建立 用 于 显示 垂直 排列 线 
性 布局 的 XML 文件 。 右 击 /res/layout 文件 夹 , 选 择 New File 打开 新 文件 建立 向 导 ， 
文件 名 为 main. vertical. xml, 保 存 位 置 为 LinearLayout/res/layout, 如 图 5. 13 所 示 。 


© New File 


File 


Create a new file resource. 


Enter or select the parent folder: 


LinearLayout/res/layout 


ù 
GS LinearLayout 
D assets 
由 - 色 bin 
Gi gen [Generated Java Files] 
GB res 
© drawable 
(E layout 


File nanei [nsin vertical 


Advanced >> 


Q 


图 5.13 新 文件 建立 向 导 


双击 新 建立 的 /res/layout/main_vertical. xml 文件 ,Eclipse 将 打开 界面 布局 的 可 视 


化 编辑 器 ,如 图 5. 14 所 示 。 可 视 化 编辑 器 项 部 是 资源 配置 清单 ,可 以 根据 手机 的 配置 不 
同 选择 不 同 的 资源 ,主要 用 来 实现 应 用 软件 的 本 地 化 。 下 部 左 侧 是 界面 布局 和 界面 控 


件 ,用 户 可 以 将 需要 的 布局 和 


I 控件 拖 搜 到 右面 的 可 视 化 界面 中 ,并 修改 布局 和 控件 的 属 


aa UI 
DÉI Hori zontalScrollView 
(T ImageSwi teher 
(I) LinearLayout 
(I)ListVi ew 
(W)Medi Controller 

A 


@ Views 
(8) Anal oc TO 
@ AntoCompleteTextView 
(B) Button 
(C) CheckBox 
(C) Chrononeter 


ann 
Layout | main_vertical. xml 


图 5.14 


nec ANC Jis v| [2 M| Orient v| Oefa) 国 
Density Touch s| Defaul (| Keybrd s| Oefa 国 Wefaul [| Nav [@efault) | 
Editing config: default Size k | [Theme 图 | [create 
(Layouts 


界面 布局 的 可 视 化 编辑 器 
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TE. du AE TO BP SE Td. SC Ag A JE IA Ek PA E 
FP fA AY“ Layout” fll" main, vertical. xml” 能 够 在 可 视 化 编辑 器 和 XML 文件 编辑 器 之 间 
切换 。 

在 Eclipse 右边 的 Outline 中 ,双击 LinearLayout, 打开 线性 布局 的 属性 编辑 器 。 线 
性 布局 的 排列 方法 主要 由 Orientation 属性 进行 控制 , vertical 表示 垂直 排列 ,horizontal 
表示 水 平 排列 。 选 择 Orientation ff] fft Jy vertical, 如 图 5. 15 所 示 ,表示 该 线性 布局 为 垂 
直 排 列 。 默 认 情 况 下 ,Layout height 的 值 为 wrap_content, 表 示 线 性 布局 高 度 等 于 所 有 
子 控件 的 高 度 总 和 ,也 就 是 线性 布局 的 高 度 会 刚好 将 所 有 子 控件 包含 其 中 。 将 Layonut 
width 属性 的 值 改 为 fill_parent, 表 示 线 性 布局 宽度 等 于 父 控件 的 宽度 ,就 是 将 线性 布局 
在 横向 上 占据 父 控件 的 所 有 空间 。 


Property 
Next focus left 


Next focus right 
Next focus up 
Orientation 


Padding 

Padding bottom 

Padding left 
mn 


图 5.15 修改 线性 布局 的 Orientation 属性 

打开 XML 文件 编辑 器 ,main_vertical. xml 文件 的 代码 如 下 : 
1 <?xml version= "1.0"enooding- "utf- 82» 
2 <Linearlayout 
3 smlns:android= "http: //schemas android. cam/apk/res/android" 
4 android:layout width- "fill parent" 
5 android:layout height= "wrap content" 
6 android:orientation= "vertical" 
7 — «/Lirearlayout^ 

第 2 行 代码 是 声明 XML 文件 的 根 元 素 为 线性 布局 ,第 4.5.6 行 代码 是 在 属性 编辑 
器 中 修改 过 的 宽度 .高度 和 排列 方式 的 属性 。 可 见 ,用 户 在 可 视 化 编辑 器 和 属性 编辑 器 
中 的 任何 修改 ,都 会 同步 反映 在 XML 文件 中 ;反之 ,用 户 es 
对 XML 文件 的 修改 ,也 会 影响 可 视 化 编辑 器 和 属性 编辑 
器 的 内 容 。 

然后 ,用户 按照 Text View, EditText, Button, Button mm 
的 顺序 ,将 4 个 界面 控件 先后 拖 搜 到 可 视 化 编辑 器 中 ,所 
有 控件 会 按照 拖 搜 的 顺序 显示 在 可 视 化 编辑 器 中 ,如 。 图 5 16 修改 线性 布局 的 
图 5. 16 所 示 。 所 有 控件 都 自动 获取 控件 名 称 ,并 把 该 名 Orientation 局 性 
称 显示 在 控件 上 ,如 TextView01、EditText01、Button01 
和 Button02 等 。 

将 界面 控件 位 置 确定 后 ,按照 表 5. 1 修改 界面 控件 的 属性 。 从 表 5.1 中 可 以 发 


Button02 


dans 
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现 , 所 有 界面 控件 都 有 一 个 共同 的 属性 ID. ID 是 一 个 字符 串 ,编译 时 被 转换 为 整数 ， 
可 以 用 来 在 代码 中 引用 界面 元 素 ,一 般 仅 在 代码 中 需要 动态 修改 的 界面 元 素 时 才 为 界 
面 元 素 设置 ID, 反 之 则 不 需要 设置 ID。 本 例 中 没有 代码 中 引用 任何 界面 元 素 , 因 此 完 
全 可 以 不 必 设 置 ID, 但 为 了 说 明 ID 的 用 途 和 使 用 方法 ,在 本 例 中 为 所 有 的 界面 控件 设 
置 ID。 
表 5.1 线性 布局 界面 控件 的 属性 设置 
编号 类 型 属 性 D 
Id @ + id/label 
1 TextView 
Text 用 户 名 : 
Id (à + id/entry 
2 EditText Layout width fill_parent 
Text [null] 
Id @ -- id/ok 
3 Button 
Text 确认 
Id @ +id/cancel 
4 Button 
Text 取消 
在 修改 完 所 有 界面 控件 的 属性 后 ,可 以 从 可 视 化 编辑 器 中 发 现 ,界面 控件 的 中 文字 
符 都 显示 为 “ 口 ”, 这 是 因为 可 视 化 编辑 器 还 不 能 很 好 地 支持 中 文字 符 。 但 在 打开 XML 


文件 编辑 器 查看 main vertical. xml 文件 代码 ,发 现在 属性 编辑 器 内 填 和 人 的 文字 已 经 正常 
写 人 到 XML 文件 中 ,例如 第 11.20.25 行 代码 。 


1 
2 
3 
4 
5 
6 
7 
8 
9 


<?xml version- "1.0"encoding- "utf- 8"?> 
< LinearLayout 
xmlns:android- "http: //schemas android. can/apk/res/android" 
android:layout width- "fill parent" 
android:layout height- "wrap content" 
android:orientation= "vertical" 


< TextView android:id- "@ + id/label" 
android:layout width- "wrap content" 
android:layout height= "wrap content" 
android:text- "f P 4& :"> 

< /TextView^ 

< EditText android:id- "@ + id/entry" 
android:layout height= "wrap content" 
android:layout width= "fill parent" 

< /EditText> 
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17 < Button android: id= "@ + id/ok" 
18 android: layout width= "wrap content" 
19 android: layout height- "wrap content" 
20 android:text- "ii "> 

21 < /Button> 

22 < Button android:id- "@ + id/cancel" 

23 android:layout width "wrap content" 
24 android:layout height- "wrap content" 
25 android:text- "Hi il "> 

26 < /Button» 


Z7 < /Linearlayat> 

最 后 ,将 LinearLayout. java 文件 中 的 setContentView (R. layout. main), 更 改 为 
setContentView(R. layout. main_vertical) 。 运 行 后 的 结果 如 图 5. 12(a) 所 示 。 

建立 横向 排列 的 线性 布局 的 过 程 与 上 述 的 纵向 线性 布局 非常 相似 ,注意 以 下 几 个 关 
键 点 即 可 : 

(D 建立 main horizontal. xml 文件 。 

(2) 线性 布局 的 Orientation 属性 的 值 设 置 为 horizontal 。 

(3) 将 EditText 的 Layout width 属性 的 值 设 置 为 wrap_content 。 

(4) 将 LinearLayout. java 文件 中 的 setContentView(R. layout. main_vertical) 修改 


为 setContentView(R. layout. main_ horizontal) 。 
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框架 布局 (FrameLayout) 是 最 简单 的 界面 布局 ,是 用 来 存放 一 个 元 素 的 空白 空间 , 且 
子 元 素 的 位 置 是 不 能 够 指定 的 ,只 能 够 放置 在 空白 空间 的 左上 角 。 如 果 有 多 个 子 元 素 ， 
后 放置 的 子 元 素 将 遮挡 先 放 置 的 子 元 素 。 

为 了 更 好 地 理解 框架 布局 ,使 用 Android SDK 中 提供 的 层级 观察 器 (Hierarchy 
Viewer) 进 一 步 分 析 界 面 布局 。 层 级 观察 器 能 够 对 用 户 界 面 进行 分 析 和 调试 ,并 以 图 形 
化 的 方式 展示 树 形 结构 的 界面 布局 ,另外 ,还 提供 了 一 个 精确 的 像素 级 观察 器 (Pixel 
Perfect View) ,以 栅 格 的 方式 详细 观察 放大 后 的 界面 界面 。 

在 模拟 器 上 运行 5. 3. 1 节 的 垂直 排列 线性 布局 的 示例 ,在 层级 观察 器 中 获得 示例 界 
面 布局 的 树 形 结构 图 ,如 图 5. 17 所 示 。 

结合 界面 布局 的 树 形 结构 图 ( 见 图 5. 17) 和 示意 图 ( 见 图 5. 18) ,分 析 不 同 界面 布局 
和 界面 控件 的 区 域 边界 。 用 户 界面 的 根 节点 (#0@43599ee0) 是 线性 布局 ,其 边界 是 整 
个 界面 ,也 就 是 示意 图 的 最 外 层 的 实心 线 。 根 节点 右 侧 的 子 节点 (#0@43599a730) 是 框 
架 布 局 , 仅 有 一 个 节点 元 素 (#0@4359ad18), 这 个 子 元 素 是 TextView 控件 ,用 来 显示 
Android 应 用 程序 名 称 , 其 边界 是 示意 图 中 的 区 域 1。 因 此 框架 布局 元 素 #0@ 
43599a730 的 边界 是 同 区 域 1 的 高 度 相同 ,宽带 充满 整个 根 节点 的 区 域 。 这 两 个 界面 元 
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PhoneWindow$DecorView 
#0@43599458 
NO_ID 


LinearLayout 
FrameLayout 


#0@43599ee0 
NO_ID 
FrameLayout 
#1@4359b858 #0@4359a730 


id/content NO_ID 


LinearLayout 


#0@4359bd60 
NO_ID 
7 TextView 
#0@4359ad18 
TextView EditText Button Button id/title 
#0@4359bfa8 | | #1@4359c5f8 #2@4359d5d8 | | #3@4359de18 
id/label id/entry id/ok id/cancel 


图 5.17 界面 布局 的 树 形 结构 图 

素 是 系统 自动 生成 的 ,一 般 情况 下 用 户 不 能 修改 
根 节点 左 侧 的 子 节点 (# 1@4359b858) 也 | 民有 EET 

是 框架 布局 ,边界 是 区 域 2 到 区 域 7 的 全 部 空 
间 。 其 下 仅 有 一 个 子 节点 (#0@4359bd60) 元 
素 是 线性 布局 ,因为 线性 布局 的 Layout width 
属性 设置 为 fill_parent, Layout height 属性 设置 
为 wrap_content, 因 此 该 线性 布局 的 宽度 就 是 其 ”| 区 域 5 
父 节点 #1@4359b858 的 宽带 ,高 度 等 于 所 有 
子 节点 元 素 的 高 度 之 和 。 线 性 布局 #0@ 
4359bd60 的 4 个 子 节点 元 素 # 0@4359bfa8、 
# 1(94359c5[8, # 2@4359d5d8 Fil # 3 @ 
4359de18 的 边界 ,分 别 是 界面 布局 示意 图 中 的 
区 域 2、 区 域 3、 区 域 4 和 区 域 5。 
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表格 布局 (TableLayout) 也 是 一 种 常用 的 界面 布局 , 它 将 屏幕 划分 网 格 ,通过 指定 行 
和 列 可 以 将 界面 元 素 添加 的 网 格 中 。 对 比 网 格 布局 的 示意 图 ( 见 图 5. 19) 和 效果 图 ( 见 
图 5.20), 可 以 发 现 网 格 的 边界 对 用 户 是 不 可 见 的 。 表 格 布局 还 支持 府 套 ,可 以 将 另 一 个 


图 5.18 界面 布局 的 示意 图 
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表格 布局 放置 在 前 一 个 表格 布局 的 网 格 中 ,也 可 以 在 表格 布局 中 添加 其 他 界面 布局 , 例 
如 线性 布局 ,相对 布局 等 等 。 

参照 5. 3. 2 节 所 用 的 界面 示例 ,使 用 表格 布局 实现 用 户 界 面 。 建立 一 个 新 的 
Android 工程 ,工程 名 称 为 TableLayout, 在 /res/layout/main. xml 文件 中 设计 基于 表格 
布局 的 用 户 界 面 。 在 表格 布局 中 设计 一 个 2X2 的 网 格 , 每 个 网 格 中 置 放 一 个 界面 控件 ， 
实现 效果 如 图 5. 20 所 示 。 


TableLayout 


Row 1 TextView EditText 


图 5.19 表格 布局 的 示意 图 图 5.20 表格 布局 的 效果 图 


建立 表格 布局 的 示例 并 不 困难 ,参照 5. 3. 2 节 的 示例 可 以 很 容易 地 实现 ,但 要 注意 
以 下 几 点 : 

(1) 向 界面 中 添加 一 个 线性 布局 ,无 需 修 改 布局 的 属性 值 。 其 中 , Id 属性 为 
TableLayout01,Layout width 和 Layout height 属性 都 为 wrap_content, 

(2) 向 TableLayout01 中 添加 两 个 TableRow。TableRow 代表 一 个 单独 的 行 , 每 
行 被 划分 为 几 个 小 的 单元 ,单元 中 可 以 添加 一 个 界面 控件 。 其 中 ,Id 属性 分 别 为 
TableRow01 和 TableRow02, Layout width 和 Layout height 属性 都 为 wrap. content, 

(3) 通过 Outline, H] TableRow01 中 添加 TextView 和 EditText, 如 图 5. 21 所 示 。 


Ocreate a nex element at the top level, in TableLayoutO! (TableLayout). 
t-|?ole” OCreate a new element in the selected element, TableLayoutO! (TableLayout) > TableRowOl (TableRow) 
号 [T] TableLayoutOl (TableLayout) 


TableRow0l (TableR [ spinner 

G-(T) TableRow02 (TableRo of Cut Sur facevi ev 
coy 国 raakost 
(Baste (T)TableLayout 


Dësen 
DI 


Leger. DESEE 


TU 
$ Down 


android widest, TextView rm 


Properties 


图 5.21 向 TableRow 中 添加 界面 控件 


(4) 通过 Outline 向 TableRow02 中 添加 两 个 Button。 
(5) 参考 表 5.2 设置 TableRow 中 4 个 界面 控件 的 属性 值 。 
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R52 表格 布局 界面 控件 的 属性 设置 


编号 类 型 属 性 值 

Id @ + id/label 
Text 用 户 名 : 

1 TextView Gravity right 
Padding 3dip 
Layout width 160dip 
Id @+id/entry 
Text [null] 

2 EditText 
Padding 3dip 
Layout width 160dip 
Id @-+ id/ok 

3 Button Text 确认 
Padding 3dip 
Id @ + id/cancel 

4 Button Text 取消 
Padding 3dip 


main. xml 文件 的 完整 代码 如 下 : 


<?xml version= "1.0"encoding= "utf- 8"?» 


1 
2 

3 <TableLayout android:id- "@ + id/TableLaycutOl" 

4 android: layout_width= "fill parent" 

5 android: layout_height= "fill parent" 

6 xmins:android- "http: //schemas android.con/apk/res/android"> 
j < TableRow android:id- "@ + id/TableRow01" 

8 android:layout width= "wrap content" 

9 android:layout height= "wrap content" 


10 « TextView android:id- "@ + id/label" 

a android:layout height- "wrap content" 
12 android:layout width- "160dip" 

13 android:gravity- "right" 

14 android:text- "H P! 44 : " 

15 android:padding- "3dip"> 

16 < /TextView> 

17 < EditText android:id- "@ + id/entry" 

18 android:layout height- "wrap content" 


19 android:layout width= "160dip" 


20 android:padding= "3dip"> 

21 < /EditText> 

2 < /TableRow> 

23 < TableRow android:id- "@ + id/TableRow02" 

24 android:layout_width= "wrap content" 

25 android:layout height- "wrap content'- 

26 « Button android:id- "@ + id/ok" 

2 android:layout height- "wrap content" 
28 android:padding= "3dip" 

29 android:text- "i jÀ "> 

30 « /Button» 

3l < Button android:id- "@ + id/Button02" 

E^ android:layout width- "wrap content" 
33 android:layout height- "wrap content" 
34 android:padding- "3dip" 

35 android:text- "HB Lil "> 

36 < /Batton> 

37 < /TableRow> 

38 < /TableLayout> 
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第 3 ITRE T <TableLayout> by 4$ E BH tf Jg A 7 行 和 第 23 行 代码 声明 
了 两 个 TableRow 元 素 ,用 来 表示 布局 中 的 两 行 ;第 12 行 利用 宽度 属性 android: layout 


width ,将 TextView 元 素 的 宽度 指定 为 160dip; 第 13 行使 用 属性 android: gravity. $ 


Text View 中 的 文字 对 齐 方式 指定 为 右 对 齐 ; 第 15 行使 用 属性 android: padding, 声 明 


TextView 元 素 与 其 他 元 素 的 间隔 距离 为 3dip。 
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相对 布局 (RelativeLayout) 是 一 种 非常 灵活 的 布局 方式 ,能 够 通过 指定 界面 元 素 与 
其 他 元 素 的 相对 位 置 关 系 , 确 定 界面 中 所 有 元 素 的 布局 位 置 。 相 对 布局 和 线性 布局 有 着 
共同 的 优点 ,能 够 最 大 程度 保证 在 各 种 屏幕 类 型 的 手机 上 正确 显示 界面 布局 。 

图 5.22 是 相对 布局 的 一 个 示例 ,为 了 便于 理解 , 先 用 文字 描述 对 界面 元 素 的 添加 顺 
序 和 相互 关系 进行 说 明 。 添 加 TextView 控件 ( “用户 名 ”) ,相对 布局 会 将 TextView 控 


m DM G 5:01 AM 
‘RelativeLayout 


件 放置 在 屏幕 的 最 上 方 ;然后 添加 Edit Text 控件 ( 输 
AME) ,并 声明 该 控件 的 位 置 在 TextView 控件 的 下 
方 , 相 对 布局 会 根据 TextView 的 位 置 确定 EditText 
控件 的 位 置 ;之 后 添加 第 一 个 Button 控件 (“取消 ” 按 
钮 ) ,声明 在 EditText 控件 的 下 方 , 且 在 父 控件 的 最 右 
边 ;最 后 ,添加 第 二 个 Button 控件 (“确认 ”按钮 ) ,声明 
该 控件 在 第 一 个 Button 控件 的 左 方 , 且 与 第 一 个 
Button 控件 处 于 相同 的 水 平 位 置 。 
main. xml 文件 的 完整 代码 如 下 : 


图 5.22 相对 布局 
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1 <?xml version= "1.0"encoding= "utf- 8"2> 
2 
3  «Relativelayout android:id- "@ + id/Pelativelayout01" 
4 android:layout width- "fill parent" 
5 android:layout height- "fill parent" 
6 xml ns:android- "http: //schemas .android.can/apk/res/android"> 
d < Text View android:id- "@  id/label" 
8 android:layout height- "wrap content" 
9 android:layout width- "fill parent" 

0 android:text- "用 户 名 : "> 

1 < /TextView> 
12 <EditText android:id- "@ + id/entry" 

3 android: layout height- "wrap content" 

4 android:layout width= "fill parent" 

5 android:layout below- "@ id/label"> 

6 < /EditText^ 

7 < Button android: id= "@ + id/cancel" 

8 android:layout height- "wrap content" 

9 android:layout width= "wrap content" 
20 android:layout alignParentRight- "true" 
21 android:layout marginleft- "10dip" 
22 android:layout below- "8 id/entry" 
23 android:text- "Hi ilf "> 
24 < /Button» 
25 < Button android:id="@ + id/ok" 
26 android:layout height- "wrap content" 
27 android:layout width= "wrap content" 
28 android:layout toleftOf- "@ id/cancel" 
29 android:layout alignTop- "8 id/cancel" 
30 android:text- "fifi i "> 
31 </Button> 


32 < /RelativeLayout> 


在 上 面 的 代码 中 ,首先 在 第 3 行使 用 了 二 RelativeLayout 二 标签 声明 一 个 相对 布局 ; 
第 15 行使 用 位 置 属 性 android:layout_below ,确定 EditText 控件 在 ID 为 label 的 元 素 下 
方 ;第 20 行使 用 属性 android:layout_alignParentRight, 声 明 该 元 素 与 其 父 元 素 的 右边 边 
界 对 齐 ; 第 21 行使 用 属性 android:layout_marginLeft, 将 该 元 素 向 左 移动 10dip; 第 22 fT 
声明 该 元 素 在 ID 为 entry 的 元 素 下 方 ;第 28 行 声明 使 用 属性 android:layout_toLeftOf， 
声明 该 元 素 在 ID 为 cancel 元 素 的 左边 ;第 29 行使 用 属性 android:layout_alignTop ,声明 
该 元 素 与 ID 为 cancel 的 元 素 在 相同 的 水 平 位 置 。 


535 绝对 布局 
绝对 布局 (AbsoluteLayout) 能 通过 指定 界面 元 素 的 坐标 位 置 ,来 确定 用 户 界面 的 整 


体 布局 。 绝 对 布局 是 一 种 不 推荐 使 用 的 界面 布局 ,因为 通 


置 后 ,Android 系统 不 能 够 根据 不 同 屏幕 对 界面 元 素 
的 位 置 进行 调整 ,降低 了 界面 布局 对 不 同类 型 和 尺寸 
屏幕 的 适应 能 力 。 使 用 绝对 布局 往往 在 目标 手机 上 非 
常 完 美 , 但 在 其 他 不 同类 型 的 手机 上 ,界面 布局 却 变 得 
混乱 不 堪 。 

图 5.23 是 绝对 布局 的 一 个 示例 ,每 一 个 界面 控件 
都 必须 指定 坐标 (X,Y) ,例如 “确认 ”按钮 的 坐标 是 
(40,120),“ 取 消 ” 按 钮 的 坐标 是 (120,120)。 和 坐标 原点 
(0,0) 在 屏幕 的 左上 角 。 

下 面 给 出 main. xml 文件 的 完整 代码 : 


M Anod 用 户 界 面 89 


过 X 轴 和 Y 轴 确 定 界面 元 素 位 
D 


ab Ee 3:06 AM 


AbsoluteLayout 


图 5.23 绝对 布局 


1 <?xml version= "1.0"encoding= "utf- 8"?> 

2 

3 < AbsoluteLayout android: id= "@ + id/AbsolutelayoutOl" 
4 android: layout_width= "fill parent" 

5 android: layout_height= "fill parent" 

6 xmlns:android- "http: //schemas .android.can/apk/res/android"> 
y « TextView android:id- "@ + id/label" 

8 android:layout x- "40dip" 

9 android:layout y- "40dip" 

10 android:layout height- "wrap content" 
1 android:layout width- "wrap content" 
12 android:text- "用 户 名 : "> 

13 < /TextView> 

14 < EditText android:id- "@ + id/entry" 

15 android:layout x- "40dip" 

16 android:layout y= "60dip" 

17 android:layout height- "wrap content" 
18 android: layout_width= "150dip"> 

19 < /EditText> 

20 < Button android:id- "@ + id/ok" 

2 android:layout width= "70dip" 

22 android:layout height- "wrap content" 
23 android:layout x- "40dip" 

24 android:layout y= "120dip" 

25 android:text- "Wii "> 

26 < Button» 

21 < Button android:id- "@ + id/cancel" 

28 android:layout width= "70dip" 

29 android:layout height- "wrap content" 
30 android:layout x- "120dip" 

a android:layout y= "120dip" 


32 android:text= "BUA "> 


90 人 six 


33 < /Button» 
34  «/Bosolutelayout^ 
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菜单 是 应 用 程序 中 非常 重要 的 组 成 部 分 ,能 够 在 不 占用 界面 空间 的 前 提 下 ,为 应 用 
程序 提供 了 统一 的 功能 和 设置 界面 ,并 为 程序 开发 人 员 提 供 了 易于 使 用 的 编程 接口 。 
Android 系统 支持 三 种 菜单 , 即 选项 菜单 (Option Menu) 、 子 菜单 (Submenu) 和 快捷 菜单 


(Context Menu) 。 


541 选项 菜单 


选项 菜单 是 一 种 经 常 被 使 用 的 Android 系统 菜单 ,用 户 可 以 通过 “菜单 键 "(MENU 
key) 打 开 选 项 菜单 。 选 项 菜单 分 为 两 种 , 即 图 标 菜单 (Icon Menu) 和 扩展 菜单 (Expanded 
Menu) ,通过 “菜单 键 > 直 接 打 开 的 是 图 标 菜单 ,如 图 5. 24 所 示 。 顾 名 思 义 ,图 标 菜 单 就 
是 能 够 同时 显示 文字 和 图 标的 菜单 ,最 多 支持 6 个 子 项 ,如 果子 项 多 余 6 个 , 则 需要 扩展 
菜单 显示 其 他 的 子 项 。 

扩展 菜单 是 垂直 的 列表 型 菜单 ,如 图 5. 25 所 示 , 仅 在 图 标 菜 单子 项 多 于 6 个 时 才 出 
现 , 通 过 点 击 图 标 菜单 最 后 的 子 项 More 才能 打开 。 扩 展 菜单 不 能 显示 图 标 , 但 支持 单 选 
框 和 复 选 框 ;相反 ,图 标 菜单 支持 显示 图 标 , 但 不 支持 单 选 框 和 复 选 框 。 


菜单 子 项 5 

菜单 子 项 6 

菜单 子 项 7 
菜单 子 项 8 国 

菜单 子 项 0 | ”菜单 子 项 1 菜单 子 项 2 

we a 菜单 子 项 9 国 
m d 菜单 子 项 4 More 菜单 子 项 10 Z 
图 5.24 图 标 菜单 图 5.25 扩展 菜单 


为 了 能 够 在 Android 应 用 程序 中 使 用 选项 菜单 ,必须 重 载 Activity 的 onCreate- 
OptionsMenu() 函 数 。 该 函数 在 用 户 首次 使 用 选项 菜单 时 被 调用 ,一 般 用 来 初始 化 菜单 
子 项 的 相关 内 容 , 包 括 设置 菜单 子 项 自身 的 子 项 ID 和 组 ID, 菜 单子 项 显示 的 文字 和 图 片 
等 信息 。 
final static int MENU DOWNLOAD-Menu.FIRST; 
final static int MENU UPLOAD=Menu.FIRST+ 1; 

@ Override 
public boolean onCreateOptionsMenu (Menu menu) { 


mB WN 
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menu.add (0,MENU DOWNLOAD, 0, "F $R it t"); 
menu.add (0,MENU_UPLOAD,1,"b fe it i"); 
return true; 


o A o a 


} 


一 般 将 菜单 子 项 ID 定义 成 静态 常量 (第 1 行 和 第 2 行 ), 并 使 用 静态 常量 Menu. 
FIRST( 整 数 类 型 , 值 为 1) 定义 第 一 个 菜单 子 项 ,以 后 的 菜单 子 项 仅 需 在 Menu. FIRST 
增加 相应 的 数值 即 可 。 在 onCreateOptionsMenu O 函数 中 ,函数 的 返回 值 类 型 为 布尔 (第 
7 £30 ,返回 true 将 显示 在 函数 中 设置 的 菜单 ,否则 将 不 能 够 显示 菜单 。Menu 对 象 (第 4 
行 ) 作 为 一 个 参数 被 传递 到 函数 内 部 ,因此 在 onCreateOptionsMenu O PAP. A nf UI 
使 用 Menu 对 象 的 add O Ph BS INE AFI, add O Ph BAY MF : 


MenuItem android.view.Menu.add (int groupId, int itemId, int order, CharSequence title) 


add() 函 数 的 第 1 个 参数 groupld 是 组 ID ,用 以 批量 地 对 菜单 子 项 进行 处 理 和 排序 ; 
第 2 关 参 数 itemId 是 子 项 ID ,是 每 一 个 菜单 子 项 的 唯一 标识 ,通过 子 项 ID 使 应 用 程序 
能 够 定位 到 用 户 所 选择 的 菜单 子 项 ;第 3 个 参数 order 是 定义 菜单 子 项 在 选项 菜单 中 的 
排列 顺序 ;第 4 个 参数 title 是 菜单 子 项 所 显示 的 标题 。 

另外 ,还 可 以 通过 setIconO BR RA setShortcut() 国 数 ,为 菜单 子 项 添加 图 标 和 快捷 键 。 
setShortcut O 函数 第 一 个 参数 是 为 数字 键盘 设 定 的 快捷 键 ,第 二 个 参数 是 为 全 键盘 设 定 的 
快捷 键 , 且 不 区 分 字母 的 大 小 写 。MENU_DOWNLOAD 菜单 设置 图 标 和 快捷 键 的 代码 。 


1 menu.add (0,MENU_DOWNLOAD, 0, "下 载 设置 ") 
2 .SetIcon (R.drawable .download) ; 
3 .setShortcut ("0", 'd"); 


第 2 行 代码 中 使 用 了 新 的 图 像 资 源 ,用 户 将 需要 使 用 的 图 像 文件 拷贝 到 /res/ 
drawable 目录 下 。 

onCreateOptionsMenu() 函 数 仅 在 第 一 次 使 用 菜单 时 被 调用 一 次 ,如 果 和 希望 打开 菜 
单 时 ,能够 动态 的 添加 、 删 除 菜单 子 项 ,或 修改 菜单 的 标题 .图 标 和 可 见 性 等 内 容 , 则 需要 
重 载 onPrepareOptionsMenu() PRI, onPrepareOptionsMenu O PR Zi ff) 3 EHE B0 er 3 
onCreateOptionsMenu() 函 数 相 同 ,返回 true 则 显示 菜单 ,返回 false 则 不 显示 菜单 。 下 
面 的 代码 是 在 用 户 每 次 打开 选项 菜单 时 ,在 菜单 子 项 中 显示 用 户 打开 该 子 项 的 次 数 。 


1l static int MenuUploadCounter- 0; 

2 € Override 

3 public boolean onPrepareOptionsMenu (Menu menu) { 

4 MenuItem uploadItem- menu.findItem(MENU UPLOAD) ; 

5 uploadItem.setTitle(" E f£ WE H :"+ 
String.valueof (MenuUploadCounter)) ; 

6 return true; 

7 ) 


代码 中 设置 一 个 菜单 子 项 的 计数 器 (第 1 行 ), 用 来 统计 用 户 打 开 * 上 传 设置 ? 子 项 的 
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次 数 。 通 过 将 菜单 子 项 的 ID 传递 给 menu. findItem() 函 数 ,获取 到 菜单 子 项 的 对 象 (第 4 
行 ) ,并 且 通 过 Menultem 的 setTitleO 函数 修改 贰 单 的 标题 (第 5 行 )。 

在 Android 系统 中 ,所 有 荣 单 子 项 的 都 使 用 同一 个 处 理 函 数 onOptionsItemSelected O . 
对 菜单 选择 事件 进行 处 理 , 且 该 函数 在 每 次 用 户 单 击 菜单 子 项 时 都 会 被 调用 。 下 面 的 代 
码 说 明了 如 何 通 过 菜单 子 项 的 子 项 ID 执行 不 同 的 操作 。 


1 @ Override 

2 public boolean onOptionsItemSelected (MenuItem item) { 
3 switch (item.getItemld()) { 

4 case MENU DOWNLOAD: 

5 MenuDownlaodCounter+ + ; 
6 retum true; 

7 case MENU_UPLOAD: 

8 MenuUploadCountert + ; 

9 return true; 

10 ) 

11 retum false; 

12 } 


onOptionsItemSelected() 的 返回 值 表示 是 否 对 菜单 的 选择 事件 进行 处 理 ,如 果 已 经 
处 理 过 则 返回 true, 否 则 返回 false。 第 2 行 的 Menultem. getItemId O PR Zi nf VA ZK BC gk 
选择 菜单 子 项 的 ID。 

完整 代码 请 参考 OptionsMenu 程序 ,程序 运行 后 ,通过 单 击 “ 菜 单 键 ”可 以 调 出 程序 
设计 的 两 个 菜单 子 项 ,如 图 5. 26 所 示 。 


OptionsMenu 


© 文档 操作 子 菜单 


新 建文 档 
打开 文档 
关闭 文档 
图 5.26 OptionsMenu 程序 运行 结果 图 5.27 子 菜单 
542 子 菜单 


子 菜单 是 能 够 显示 更 加 详细 信息 的 菜单 子 项 。 传 统 的 子 菜 单一 般 采用 树 形 层次 化 
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结构 ,但 Android 系统 却 使 用 了 浮动 窗 体 的 形式 显示 菜单 子 项 ,如 图 5. 27 所 示 。 采 用 与 
众 不 同 的 显示 方式 ,主要 是 为 了 更 好 适应 小 屏幕 的 显示 方式 。 

Android 系统 的 子 菜单 使 用 非常 灵活 ,可 以 在 选项 菜单 或 快捷 菜单 中 使 用 子 菜单 ,有 
利于 将 相同 或 相似 的 菜单 子 项 组 织 在 一 起 ,便于 显示 和 分 类 。 但 是 Android 系统 的 子 菜 
单 不 支持 租 套 ,也 就 是 说 不 能 够 在 子 菜单 中 再 使 用 子 菜单 。 

子 菜单 的 添加 是 通过 addSubMenu() 函数 实现 的 ,例如 在 下 面 的 第 1 行 代 码 中 ,在 
onCreateOptionsMenu O AŠUR% DI menu 对 象 上 调用 addSubMenu O PR RM, TE 3 TA K mm. 
中 添加 一 个 菜单 子 项 ,用 户 点 击 后 可 以 打开 子 菜单 。addSubMenu() 函 数 与 选项 菜单 中 
使 用 过 的 add O 函数 支持 相同 的 参数 ,同样 可 以 指定 菜单 子 项 的 ID .组 ID 和 标题 等 参 
数 ,并 且 是 能 够 通过 setIcon O 函数 菜单 显示 的 图 标 。 


1 SubMenu uploadMenu= (SubMenu) menu.addSubMenu (0,MENU_UPLOAD, 1," E 1% it i ") 
-SetIcon (R.drawable.upload) ; 
uploadMenu.setHeaderIoon (R.drawable.upload); 


uploadMenu.setHeaderTitle ("上 传 参数 设置 "); 
uploadMenu.add(0,SUB MNU UPLOAD A,0," 上 传 参数 a"; m 
vuploadVeni.ac (0, SUB. MENU UPLOAD B,0," 上 传 参 数 B"); 


代码 第 2 行使 用 setHeaderIconO ARM. 4E X. T FHM 
的 图 标 ;第 3 行 定义 了 子 菜单 的 标题 ,如 果 不 规定 子 菜单 的 
标题 , 子 菜单 将 显示 父 菜单 子 项 的 标题 , 即 第 1 行 代 码 中 的 
“上 传 设置 ”; 第 4 行 和 第 5 行 在 子 菜单 中 添加 了 两 个 菜单 
子 项 ,菜单 子 项 的 更 新 函数 和 选择 事件 处 理 函 数 ,仍然 使 用 围 上 传 参数 B:3 
onPrepareOptionsMenu ( ) 函数 和 onOptionsItemSelected ( ) 
函数 。 

以 5.4.1 节 的 代码 为 基础 ,将 “上 传 设置 ? 改 为 子 菜单 ， 
并 在 子 菜单 中 添加 “上 传 参数 A”" 和 “上 传 参 数 B” 两 个 菜单 
子 项 。 完 整 代码 请 参考 MySubMenu 程序 ,运行 结果 如 
图 5. 28 所 示 。 


543 快捷 菜单 


快捷 菜单 同样 采用 了 动 窗 体 的 显示 方式 ,虽然 快捷 菜单 的 实现 方式 与 子 菜单 相同 ， 
但 两 种 菜单 的 启动 方式 却 截然 不 同 。 人 快捷 菜单 类 似 于 普通 桌面 程序 中 的 “右键 菜单 ”, 当 
用 户 单 击 界面 元 素 超过 2 秒 后 ,将 启动 注册 到 该 界面 元 素 的 快捷 菜单 。 

使 用 快捷 菜单 的 方法 与 使 用 选项 菜单 的 方法 非常 相似 ,需要 重 载 onCreate- 
ContextMenu() pi All onContextItemSelected() RAL, onCreateContextMenu O PR ME 
要 用 来 添加 快捷 菜单 所 显示 的 标题 ,图 标 和 菜单 子 项 等 内 容 , 选 项 菜单 中 的 
onCreateOptionsMenu( ) 函数 仅 在 选项 菜单 第 一 次 启动 时 被 调用 一 次 ,但 快捷 菜单 的 
onCreateContextMenu() 函 数 每 次 启动 时 都 会 被 调用 一 次 。 


wm fF wN 


上 传 参数 A:2 


5.28 MySubMenu 程序 
的 运行 结果 


94 人 .sx 


final static int CONTEXT MENU 1- Menu.FIRST; 

final static int CONTEXT MENU 2=Menu.FIRST+ 1; 

final static int CONTEXT MENU 3- Menu.FIRST* 2; 

@ Override 

public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) { 

6 menu. setHeaderTitle ("RER ARA"); 

7 menu.add(0, CONTEXT MENU 1, 0, SIEHE 1"); 

8 menu.add(0, CONTEXT MENU 2, 1," AF IH 2"); 

9 menu.add(0, CONTEXT MENU 3, 2, "AF 3"); 

10 ) 


Oe wn ro 


ContextMenu 类 支持 add() PRA ARTES 7 FF) Al addSubMenu O PAK, n] LAE pe 
菜单 中 添加 菜单 子 项 和 子 菜单 。onCreateContextMenu() 函 数 (代码 第 5 行 ) 的 第 1 个 参 
数 menu 是 需要 显示 的 快捷 菜单 ;第 2 个 参数 v 是 用 户 选 择 的 界面 元 素 ; 第 3 个 参数 
menulnfo 是 所 选择 界面 元 素 的 额外 信息 。 

菜单 选择 事件 的 处 理 需 要 重 载 onContextItemSelected() 函数 ,该 函数 在 用 户 选 择 快 
捷 菜 单 中 的 菜单 子 项 后 被 调用 ,与 onOptionsItemSelected O PR Z DÉI fii DI 77 1s KA JH [i] 。 


1 @ Override 

2 public boolean onContextItemSelected (MenuTtem item) { 
3 switch (item.getItemId()) ( 

4 case CONTEXT MENU 1: 

5 IabelView.setText (" 荣 单子 项 1"); 
6 return true; 

7 case CONTEXT MENU 2: 

8 IabelView.setText ("S fF Til 2"); 
9 retum true; 

10 case CONIEXT MENU 3: 

u IabelView.setText (" 荣 单子 项 3"); 
12 return true; 

13 } 

14 return false; 

15 } 


最 后 ,还 需要 使 用 registerForContextMenu O PR Zt. p th HE Sie moral 9 TF P E 
(下 方 代码 第 7 行 )。 这 样 ,用 户 在 长 时 间 单 击 该 界面 控件 时 , 便 会 启动 快捷 菜单 。 同 时 ， 
为 了 能 够 在 界面 上 直接 显示 用 户 所 选择 快捷 菜单 的 菜单 子 项 ,在 代码 中 引用 了 界面 元 素 
TextView( 下 方 代码 第 6 行 ), 通 过 更 改 TextView 的 显示 内 容 ( 上 方 代码 第 5,8 和 11 
47) ,显示 用 户 所 选择 的 菜单 子 项 。 


E TextView LabelView- null; 
2 @ Override 
3 public void onCreate (Bundle savedInstanceState) { 
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super .onCreate (savedInstanceState) ; 
setContentView (R. layout main) ; 

LabelView= (TextView) findViewByld (R.id.label) ; 
registerForContextMenu (LabelView) ; 


co A 0 0 心 


) 


下 方 代码 是 /src/layout/main. xml 文件 的 部 分 内 容 , 第 1 行 声 明了 TextView 的 ID 
为 label, 在 上 方 代码 的 第 6 行 中 ,通过 R. id. label 将 ID 传递 给 findViewByld O Ph MK, ix 
样 用 户 便 能 够 引用 该 界面 元 素 ,并 能 够 修改 该 界面 元 素 的 显示 内 容 。 
1 <TextView ` android:id- "@+ id/label" 
2 android:layout width= "fill parent" 
3 android:layout height= "fill parent" 
4 android:text- "8 string/hello" 
5 /> 


还 有 一 点 需要 注意 ,上 方 代码 的 第 2 行 ,将 android: layout_width WEE fill parent. 
这 样 Text View 将 填充 满 父 节点 的 所 有 剩余 屏幕 空间 ,用 


回 DME 12:58 AM 
Ndi) 户 单 击 屏幕 TextView 下 方 任何 位 置 都 可 以 启动 快捷 菜 
单 。 如 果 将 android: layout_width 设置 为 wrap_content， 
则 用 户 必 须 准 确 单 击 TextView 才能 启动 快捷 菜单 。 完 整 
代码 参考 MyContextMenu 程序 ,运行 结果 如 图 5. 29 所 示 。 
RETN 在 Android 系统 中 ,菜单 不 仅 能 够 在 代码 中 定义 ,而且 
Rer 可 以 像 界面 布局 一 样 在 XML 文件 中 进行 定义 。 使 用 
XML 文件 定义 界面 菜单 ,将 代码 与 界面 设计 分 类 ,有 助 于 
KOR 简化 代码 的 复杂 程度 ,并 且 更 有 利于 界面 的 可 视 化 。 下 面 


将 快捷 菜 的 示例 程序 MyContextMen 改 用 XML 实现 ,新 
程序 的 工程 名 称 为 MyXLMContoxtMenu。 

首先 需要 创建 保存 菜单 内 容 的 XML 文件。 在 /src H 
录 下 建立 子 目 录 menu, 并 在 menu 下 建立 context_menu. 
xml 文件 ,代码 如 下 : 


5.29 MyContextMen 程序 的 
运行 结果 


1 <menu xmilns:android= "http: //schemas.android.com/apk/res/android"> 
2 < item android:id- "@ + id/contextMenul" 

3 android:title- "E D TH 1"/> 

4 < item android:id- "@ + id/contextMenu2" 

5 android:title- "H D TH 2"/> 

6 < item android:id- "@ + id/contextMenu3" 

y android:title- "5% DTN 3"/> 

8 < /menu» 


在 描述 菜单 的 XML XHEP LA EL <menu> tr (RIG 1 VEN AR. item 
标签 (代码 第 2 41 Hkc f vei PA. item s SE n] DUGB xt e SERT: RP 
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fig. XML 菜单 的 显示 结果 如 图 5. 30 所 示 。 

在 XML 文件 中 定义 菜单 后 ,在 onCreateContextMenu() 
函数 中 调用 inflater. inflate() 方 法 ,将 XML 资源 文件 传递 
给 菜单 对 象 。 


1 @ Override 
2 public void anCreateContextMenn (ContextMenu menu, 图 5.30 XML 菜单 
3 View v, ContextMenuInfo menuInfo) { 

4 MenuInflater inflater- getMenuInflater () ; 
5 

6 


inflater.inflate(R.menu.context menu, menu); 
} 


在 上 述 代 码 第 4 行 ,getMenuInflater() 为 当前 的 Activity 返回 MenuInflater。 然 后 ， 
通过 第 5 行 代 码 , 将 XML 资源 文件 R. menu. context_menu, 传 递 给 menu 这 个 快捷 菜单 
对 象 。 


55 界面 事件 


在 Android 系统 中 ,存在 多 种 界面 事件 ,如 按键 事件 .触摸 事件 、 焦 点 事件 和 菜单 事 
件 等 等 ,在 这 些 事件 发 生 时 ,Android 界面 框架 调用 界面 控件 的 事件 处 理 函 数 对 事件 进行 
处 理 。 


551 按键 事件 


在 MVC 模型 中 ,控制 器 根据 界面 事件 (UI Event) 类 型 不 同 ,将 事件 传递 给 界面 控件 
不 同 的 事件 处 理 函数 。 例 如 按键 事件 (KeyEvent) 将 传递 给 onKey() 函 数 进行 处 理 , 触 摸 
事件 (TouchEvent) 将 传递 给 on Touch O R ACHE £7 4b FH 

Android 系统 界面 事件 的 传递 和 处 理 遵循 着 一 定 的 规则 。 首 先 , 如 果 界 面 控件 设置 
了 事件 监听 器 , 则 事件 将 先 传递 给 事件 监听 器 ;相反 ,如 果 界 面 控件 没有 设置 事件 监听 
器 ,界面 事件 则 会 直接 传递 给 界面 控件 的 其 他 事件 处 理 函 数 。 即 使 界面 控件 设置 了 事 
件 监 听 器 ,界面 事件 也 可 以 再 次 传递 给 其 他 事件 处 理 函 数 ,是 否 继续 传递 事件 给 其 他 
处 理 函数 是 由 事件 监听 器 处 理 函 数 的 返回 值 决 定 的 。 如 果 监 听 器 处 理 函 数 的 返回 值 
为 true, 表 示 该 事件 已 经 完成 处 理 过 程 , 不 需要 其 他 处 理 函 数 参与 处 理 过 程 , 这 样 事件 
就 不 会 再 继续 进行 传递 。 反 之 ,如 果 监 听 器 处 理 函 数 的 返回 值 为 false, 则 表示 该 事件 
没有 完成 处 理 过 程 ,或 需要 其 他 处 理 函 数 捕获 到 该 事件 ,事件 会 被 传递 给 其 他 的 事件 
Ak HE PK AAC 

以 EditText 控件 中 的 按键 事件 为 例 , 说 明 Android 系统 界面 事件 传递 和 处 理 过 程 ， 
假设 EditText 控件 已 经 设置 了 按键 事件 监听 器 。 当 用 户 按 下 键盘 上 的 某 个 按键 时 ,控制 
器 将 产生 KeyEvent 按键 事件 。Android 系统 会 首先 判断 EditText 控件 是 否 设置 了 按键 
事件 监听 器 ,因为 EditText 控件 已 经 设置 按键 事件 监听 器 OnKeyListener, 所 以 按键 事 
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件 先 传递 到 监听 器 的 事件 处 理 函 数 onKey() 中 。 事 件 能 够 继续 传递 给 EditText 控件 的 
其 他 事件 处 理 函 数 , 完 全 根据 onKey() 函 数 的 返回 值 来 确定 。 如 果 onKey() 函数 返回 
false, 事 件 将 继续 传递 ,这样 EditText 控件 就 可 以 捕获 到 该 事件 ,将 按键 的 内 容 显示 在 
EditText 控件 中 。 如 果 onKey () FR GR E] true, 将 阻止 按键 事件 的 继续 传递 ,这 样 
EditText 控件 就 不 能 捕获 到 按键 事件 ,也 就 不 能 将 按键 内 容 显 示 在 EditText 控件 中 。 

Android 界面 框架 支持 对 按键 事件 的 监听 ,并 能 够 将 按键 事件 的 详细 信息 传递 给 处 
理 函 数 。 为 了 处 理 控 件 的 按键 事件 , 先 需要 设置 按键 事件 的 监听 器 ,并 重 载 onKey O PR 
数 。 示 例 代 码 如 下 : 


H entryText.setOnKeyListener (new OnKeyListener () { 

2 @ Override 

3 public boolean onKey (View view, int keyCode, KeyEvent keyEvent) { 
4 // 过 程 代 码 … 

5 return true/false; 

6 } 


第 1 行 代码 是 设置 控件 的 按键 事件 监听 器 。 在 代码 第 3 rr onKey O PARP, FS 1 
个 参数 view 表示 产生 按键 事件 的 界面 控件 ;第 2 个 参数 keyCode 表示 按键 代码 ;第 3 个 
参数 keyEvent 则 包含 了 事件 的 详细 信息 ,如 按键 的 重 
复 次 数 、 硬 件 编码 和 按键 标志 等 。 第 5 行 是 onKey() 函 ”区 BD 
数 的 返回 值 ,返回 true, 阻 止 事件 传递 ;返回 falses 允 许 a ”| 
继续 传递 按键 事件 。 | Eun ,阻止 将 按键 事件 传递 给 界面 

KeyEventDemo 是 一 个 说 明 如 何 处 理 按键 事件 的 
示例 。 在 这 个 示例 中 ,用 户 界面 如 图 5. 31 所 示 。 

在 KeyEventDemo 的 用 户 界 面 中 ,最 上 方 的 
EditText 控件 是 输入 字符 的 区 域 ,中 间 的 CheckBox 控 
件 用 来 控制 onKey CO 函数 的 返回 值 , 最 下 方 的 5.31 KeyEventDemo 界面 
TextView 控件 用 来 显示 按键 事件 的 详细 信息 ,包括 按 
键 动作 ,按键 代码 .按键 字符 .Unicode 编码 、 重 复 次 数 、 功 能 键 状态 、 硬 件 编码 和 按键 标 
志 。 界 面 的 XML 文件 的 代码 如 下 : 


1  «EditText android:id="@ + id/entry" 
2 android:layout width- "fill parent" 
3 android:layout height- "wrap content" 
4 « /EditText> 

5 <CheckBox android:id- "@ + id/block" 
6 android:layout width- "wrap content" 

7 android:layout height- "wrap content" 

8 android:text- "返回 true, 阻 止 将 按键 事件 传递 给 界面 元 素 "> 
9 < /CheckBox> 

10 <TextView android:id="@ + id/label" 

1 android:layout width- "wrap content" 
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12 android:layout height- "wrap content" 
13 android:text- "按键 事件 信息 "> 
14 </TextView> 


在 EditText 中 ,每 当 任何 一 个 键 子 按 下 或 抬 起 时 ,都 会 引发 按键 事件 。 但 为 了 能 够 


使 EditText 处 理 按键 事件 ,需要 使 用 setOnKeyListener O 函数 在 代码 中 设置 按键 事件 监 
听 器 ,并 在 onKey() 函 数 添加 按键 事件 的 处 理 过 程 。 


1 entryText.setOnKeyListener (new OnKeyListener () { 

2 @ Override 

3 public boolean onKey (View view, int keyCode, KeyEvent keyEvent) { 

4 int metaState- keyEvent .getMetaState () ; 
5 int unicodeChar- keyEvent .getUni codeChar () ; 

6 String msg ""; 
g msg += "fe fil BH ME :"+ Stcing.valueOf (keyEvent .getAction ())+ "^n"; 
8 msg += "fe HE [V fi :"+ String.valueOf (keyCode) - "\n"; 
9 msg += "按键 字符 :"+ (Char) unicodeChart "\n"; 

0 msg += "UNIOODE:"+ String.valueOf (unicodeChar)- "An"; 

1 msg += "E 4f YOK :"+ String.valueOf (keyEvent.getRepeatCount () ) "\n"; 
12 msg += "Sy fil HEAR AS :"+ String. valucOf (metaState) "An"; 

3 msg += "硬件 编码 :"+ String. valueOf (keyEvent .getScanCode ())+ "\n"; 
4 msg += "Hie HE pp a :"+ String. valucOf (keyEvent .getFlags ())+ "n"; 

5 labelView.setText (msg) ; 

6 if (checkBox.isChecked()) 

7 return true; 

8 else 

9 return false; 


N 
o 


) 


第 4 行 代码 用 来 获取 功能 键 状 态 。 功 能 键 包 括 左 Alt 键 、 右 Alt 键 和 Shift 键 , 当 这 
三 个 功能 键 被 按 下 时 ,功能 键 代 码 metaState 值 分 别 为 18,34 和 65; 但 没有 功能 键 被 按 下 
时 ,功能 键 代 码 metaState 值 分 别 为 0。 第 5 行 代 码 获 取 了 按键 的 Unicode 值 , 在 第 9 行 
中 ,将 Unicode 转换 为 字符 ,显示 在 TextView 中 。 第 7 行 代 码 获 取 了 按键 动作 ,0 表示 
按 下 按键 ,1 表示 抬 起 按键 。 第 7 行 代码 获取 按键 的 重复 次 数 ,但 按键 被 长 时 间 按 下 时 ， 
则 会 产生 这 个 属性 值 。 第 13 行 代码 获取 了 按键 的 硬件 编码 ,不 同 硬件 设备 的 按键 硬件 
编码 都 不 相同 ,因此 该 值 一 般 用 于 调试 。 第 14 行 获取 了 按键 事件 的 标志 名 
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触摸 屏 已 经 不 是 高 端 手机 才 有 的 配件 , 随 着 触摸 屏 生 产 成 本 的 不 断 下 降 , 目 前 很 多 
中 低 端的 手机 也 都 装 有 触摸 屏 。 伴 随 着 触摸 屏 的 普及 ,手机 的 操作 方式 也 随 之 改变 ,用 
户 已 经 不 满足 键盘 的 操作 方式 ,而 是 更 加 倾心 于 使 用 手指 在 屏幕 上 进行 操作 。 

Android 界面 框架 支持 对 触摸 事件 的 监听 ,并 能 够 将 触摸 事件 的 详细 信息 传递 给 处 
理 函 数 。 为 了 处 理 控件 的 触摸 事件 , 先 需要 设置 触摸 事件 的 监听 器 ,并 重 载 onTouch() 


函数 。 示 例 代码 如 下 : 


1 ttouchView.setOnTouchListener (new View.OnTouchListener () 
2 @ Override 

3 public boolean onTouch (View v, MotionEvent event) { 
4 // 过 程 代码 … 

5 return true/false; 

6 } 
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){ 


第 1 行 代 码 是 设置 控件 的 触摸 事件 监听 器 。 在 代码 第 3 行 的 onTouch() 函 数 中 ,第 


1 个 参数 View 表示 产生 触摸 事件 的 界面 控件 ;第 2 
个 参数 MontionEvent 表示 触摸 事件 的 详细 信息 ,如 
产生 时 间 ,坐标 和 触 点 压力 等 。 第 5 行 是 onTouchO 
函数 的 返回 值 。 

TouchEventDemo 是 一 个 说 明 如 何 处 理 触摸 事 
件 的 示例 。 在 这 个 示例 中 ,用 户 界 面 如 图 5. 32 所 示 。 

在 TouchEventDemo 的 用 户 界面 中 , 浅 蓝 色 区 域 
是 可 以 接受 触摸 事件 的 区 域 ,用 户 可 以 在 Android 模 
拟 器 中 使 用 鼠标 点 击 屏幕 ,用 以 模拟 触摸 手机 屏幕 。 
下 方 黑色 区 域 是 显示 区 域 , 用 来 显示 触摸 事件 的 类 
型 \ 相 对 坐标 、 绝 对 坐标 、 触 点 压力 、 触 点 尺寸 和 历史 
数据 量 等 信息 。 

在 用 户 界 面 中 使 用 了 线性 布局 ,并 加 入 了 3 个 
TextView 控件 ,第 1 个 TextView(ID JJ touch. area) 
用 来 标识 触摸 事件 的 测试 区 域 , 第 2 个 TextView(ID 
为 history_label) 用 来 显示 和 触摸 事件 的 历史 数据 量 ,第 
3 个 TextView(ID 为 event_label) 用 来 触摸 事件 的 详细 
坐标 、 触 点 压力 和 触 点 尺寸 。XML 文件 的 代码 如 下 : 


ed BME 3:17 PM 


TouchEventDemo 


能 摸 事件 测试 区 域 


5.32 TouchEventDemo 界面 


信息 ,包括 类 型 .相对 坐标 、 绝 对 


1 <?xml version- "1.0"encoding= "utf- 8"?» 

2 < Linearlayout xmlns:android- "http: //schemas .android.can/apk/res/android" 
3 android:orientation- "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height= "fill parent"> 

6 <TextView android:id="@ + id/touch area" 
7 android:layout width= "fill parent" 

8 android: layout_height="300dip" 

9 android:background- "# 80A0FF" 

10 android:textColor- "# FFFEFE" 

n android:text- "fih 1 St fF WU ik [X dt "> 
12 « /TextView> 

13 < TextView android:id- "8 + id/history label" 


14 android:layout width- "wrap content" 
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15 android:layout height- "wrap content" 
16 android:text- "历史 数据 量 : "> 

17 < /TextView> 

18 < TextView android:id="@ + id/event_label" 
19 android: layout width- "wrap content" 
20 android:layout height- "wrap content" 
a android:text- "触摸 事件 "> 

22 < /TextView> 


23 < /Linearlayout> 


上 面 的 代码 中 ,第 9 行 定义 了 TextView 的 背景 颜色 ,#80AOFF 是 颜色 代码 。 第 10 
行 定义 了 TextView 的 字体 颜色 。 
在 代码 中 为 了 能 够 引用 XML 文件 中 声明 的 界面 元 素 ,使 用 了 下 面 的 代码 : 


TextView labelView= null; 

labelView- (TextView) findViewById R.id.event label); 

TextView touchView- (TextView)findViewById(R.id.touch area); 

final TextView historyView- (TextView)findViewById(R.id.history label); 

当 手 指 接触 到 触摸 屏 、 在 触摸 屏 上 移动 或 离开 触摸 屏 时 ,分 别 会 引发 ACTION. 
DOWN,ACTION_UP 和 ACTION. MOVE 触摸 事件 ,而 无 论 是 哪 种 触摸 事件 ,都 会 调 
用 onTouch() 函 数 进行 处 理 。 事 件 类 型 包含 在 on Touch O pA RAY MotionEvent BACH, 
可 以 通过 getAction() 函 数 获取 到 触摸 事件 的 类 型 ,然后 根据 触摸 事件 的 不 同类 型 进行 
不 同 的 处 理 。 但 为 了 能 够 使 屏幕 最 上 方 的 TextView 处 理 触 摸 事 件 ,需要 使 用 
setOnTouchListener() 函 数 在 代码 中 设置 触摸 事件 监听 器 ,并 在 on Touch O PR BC HS J fit 
摸 事 件 的 处 理 过 程 。 
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1 touchView.setOnTouchListener (new View.OnTouchListener () ( 

2 @ Override 

3 public boolean onTouch (View v, MotionEvent event) { 

4 int action= event .getAction() ; 

5 Switch (action) ( 

6 case (MotionEvent.ACTION DOWN): 

7 Display "ACTION DON event) ; 

8 break; 

9 case (MotionEvent.ACTION UP): 

10 int historySize- ProcessHistory (event) ; 
nu historyView.setText (" 历 史 数据 量 : "+ historySize) ; 
12 Display ("ACTION UP" event) ; 

13 break; 

14 case (MotionEvent.ACTION MOVE): 

15 Display ("ACTION MOVE", event) ; 

16 break; 


17 } 
18 return true; 
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19 } 
20 DÉI 


第 7 行 代码 的 Display() 是 一 个 自 定义 函数 ,主要 用 来 显示 触摸 事件 的 详细 信息 PB 
数 的 代码 和 含义 将 在 后 面 进 行 介 绍 。 第 10 行 代码 的 ProcessHistory() 也 是 一 个 自 定 义 
函数 ,用 来 处 理 触摸 事件 的 历史 数据 ,后 面 进 行 介绍 。 第 11 行 代码 是 使 用 TextView 显 
示 历 史 数 据 的 数量 。 

MotionEvent 参数 中 不 仅 有 触摸 事件 的 类 型 信息 ,还 有 和 触 点 的 坐标 信息 ,获取 方法 是 
使 用 getX() 和 getY() 函 数 ,这 两 个 函数 获取 到 的 是 触 点 相对 于 父 界 面 元 素 的 坐标 信息 。 
如 果 需 要 获取 绝对 坐标 信息 , 则 可 使 用 getRawX() 和 getRawY() 函 数 。 触 点 压力 是 一 个 
介 于 0 和 1 之 间 的 浮 点 数 , 用 来 表示 用 户 对 和 触摸 屏 施 加 压力 的 大 小 ,接近 0 表示 压力 较 
小 ,接近 1 表示 压力 较 大 ,获取 触摸 事件 触 点 压力 的 方式 是 调用 getPressure O EBI. fth 
点 尺寸 指 用 户 接 触 触摸 屏 的 接触 点 大 小 ,也 是 一 个 介 于 0 和 1 之 间 的 浮 点 数 ,接近 0 表示 
尺寸 较 小 ,接近 1 表示 尺寸 较 大 ,可 以 使 用 getSizeO ph BORE. 

Display() 将 MotionEvent 参数 中 的 事件 信息 提取 出 来 ,并 显示 在 用 户 界面 上 。 


1 private void Display (String eventType, MotionEvent event) { 
2 int x= (int)event.getX() ; 

3 int y= (int)event.getY () ; 

4 float pressure- event .get Pressure () ; 

5 float size= event.getSize(); 

6 int RawX- (int)event.getRawX(); 

7 int RawY- (int)event.getRawY () ; 

8 
9 


String msg- ""; 

10 msg += "SE PFK : "+ eventType "n"; 

1 msg += "相对 坐标 : "+ String. valucOf (x)+ ","+ String. valucOf (y)+ "\n"; 
2 msg += " 哆 对 坐标 : "+ String. valucOf (Rawk) + ","+ String.valueOf (RawY)+ "An"; 
13 msg += "fh JR 7] : "+ String. valueOf (pressure)+", "; 

14 msg += "fjh pi of : "+ String.valueof (size)+ "An"; 

15 labelView.setText (msg) ; 

16 ) 


一 般 情 况 下 ,如 果 用 户 将 手指 放 在 触摸 屏 上 ,但 不 移动 ,然后 抬 起 手指 ,应 先后 产生 
ACTION_DOWN 和 ACTION_UP 两 个 触摸 事件 。 但 如 果 用 户 在 屏幕 上 移动 手指 ,然后 
再 抬 起 手指 , 则 会 产生 这 样 的 事件 序列 ACTION DOWN > ACTION _MOVE > 
ACTION. MOVE ACTION. MOVE----— ACTION UP, 

在 手机 上 运行 的 应 用 程序 ,效率 是 非常 重要 的 。 如 果 Android 界面 框架 不 能 产生 足 
够 多 的 触摸 事件 , 则 应 用 程序 就 不 能 够 很 精确 地 描绘 触摸 屏 上 的 触摸 轨迹 。 相 反 , 如 果 
Android 界面 框架 产生 了 过 多 的 触摸 事件 ,虽然 能 够 满足 精度 的 要 求 ,但 却 降低 了 应 用 程 
序 效率 。Android 界面 框架 使 用 了 “打包 ”的 解决 方法 。 在 触 点 移动 速度 较 快 时 会 产生 大 
量 的 数据 ,每 经 过 一 定 的 时 间 间 隔 便 会 产生 一 个 ACTION. MOVE 事件 ,在 这 个 事件 中 ， 
除了 有 当前 触 点 的 相关 信息 外 ,还 包含 这 段 时 间 间 隔 内 和 触 点 轨迹 的 历史 数据 信息 ,这 样 
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既 能 够 保持 精度 ,又 不 至 于 产生 过 多 的 触摸 事件 。 通 常情 况 下 ,在 ACTION_MOVE 的 
事件 处 理 函 数 中 ,都 先 处 理 历史 数据 .然后 再 处 理 当 前 数据 。 


1 private int ProcessHistory (MotionEvent event) 

2 { 

3 int historySize- event.getHistorySize(); 

4 for (int i=0; i «historySize; i++) { 

5 long time= event .getHistoricalEventTime (i); 

6 float pressure- event .getHistorical Pressure (i) ; 
7 float x= event.getHistoricalX(i); 

8 float y- event.getHistoricalY (i); 

9 float size= event .getHistoricalSize (i); 


10 

nu // 处 理 过 程 … 
12 } 

13 retum historySize; 
14 } 


在 ProcessHistory() AXCP ,第 3 行 代码 获取 了 历史 数据 的 数量 ,然后 在 第 4 行 至 12 
行 中 循环 处 理 这 些 历史 数据 。 第 5 行 代 码 获 取 了 历史 事件 的 发 生 时 间 , 第 6 行 代码 获取 
历史 事件 的 触 点 压力 ,第 7 行 和 第 8 行 代码 获取 历史 事件 的 相对 坐标 ,第 9 行 获取 历史 事 
件 的 触 点 尺寸 。 在 第 14 行 返回 历史 数据 的 数量 ,主要 是 用 于 界面 显示 o 

非常 可 惜 ,Android 模拟 器 并 不 支持 触 点 压力 和 和 触 点 尺 二 的 模拟 ,所 有 和 触 点 压力 恒 为 
1.0, 触 点 尺寸 恒 为 0.0。 同 时 ,作者 在 Android 模拟 器 上 也 无 法 产生 历史 数据 ,因此 历史 
数据 量 一 直 显 示 为 0。 


SI E 
1. 简 述 5 种 界面 布局 的 特点 。 


2. 参考 下 图 中 界面 控件 的 摆 放 位 置 ,分 别 使 用 线性 布局 、 相 对 布局 和 绝对 布局 实现 
用 户 界面 ,并 对 比 各 种 布局 实现 的 复杂 程度 和 对 不 同 屏幕 尺寸 的 适应 能 力 。 


3. 简 述 Android 系统 支持 的 三 种 菜单 。 
4. EditText 控件 具有 Numeric 属性 ,设置 成 integer 后 EditText 控件 中 只 能 输入 数 
字 ,而 无 法 输入 其 他 字母 或 符号 。 利 用 按键 事件 ,编程 实现 EditText 控件 的 这 一 功能 。 


组 件 通信 与 广播 消息 


Intent 是 轻 量 级 的 进程 间 通 信 机 制 , 用 于 跨 进程 的 组 件 通信 和 发 送 系 统 级 广播 。 通 
过 本 章 的 学 习 可 以 让 读者 基本 了 解 Android 系统 的 组 件 通信 原理 ,掌握 利用 组 件 通信 和 启 
动 其 他 组 件 的 方法 ,以 及 利用 组 件 通信 获取 信息 和 发 送 广播 消息 的 方法 。 

本 章 学 习 目标 : 

* 了 解 使 用 Intent 进行 组 件 通信 的 原理 

。 掌握 使 用 Intent 启动 Activity 的 方法 

。 掌握 获取 Activity 返回 值 的 方法 

。 T fi Intent 过 滤器 的 原理 与 匹配 机 制 

。 掌握 发 送 和 接收 广播 消息 的 方法 


61 Intent 


Intent 是 一 个 动作 的 完整 描述 ,包含 了 动作 的 产生 组 件 、 接 收 组 件 和 传递 的 数据 信 
息 。 当 然 , 也 可 以 将 Intent 视 为 一 个 在 不 同 组 件 之 间 传 递 的 消息 ,这 个 消息 在 到 达 接 收 
组 件 后 ,接收 组 件 会 执行 相关 的 动作 。 

由 于 Intent 的 存在 ,使 得 Android 系统 中 互相 独立 的 应 用 程序 组 件 ,成 为 了 一 
以 互相 通信 的 组 件 集 合 。 因 此 ,无 论 这 些 组 件 是 否 在 同一 个 应 用 程序 中 ,Intent 可 以 将 
一 个 组 件 的 数据 和 动作 传递 给 另 一 个 组 件 。 

Intent JJ Activity, Service 和 BroadcastReceiver 等 组 件 提供 交互 能 力 。Intent 的 一 
个 最 常见 的 用 途 就 是 启动 Activity 和 Service, 另 一 个 用 途 是 在 Android 系统 上 发 布 广播 
消息 。 广 播 消 息 可 以 是 接收 到 特定 数据 或 消息 ,也 可 以 是 手机 的 信号 变化 或 电池 的 电量 
过 低 等 信息 。 


611 启动 Acity 


在 Android 系统 中 ,应 用 程序 一 般 都 有 多 个 Activity. Intent 可 以 实现 不 同 Activity 
之 间 的 切换 和 数据 传递 。Intent 启动 Activity 方式 可 以 分 为 显 式 启动 和 隐 式 启动 。 显 式 
启动 必须 在 Intent 中 指明 启动 的 Activity 所 在 的 类 ,而 隐 式 启动 则 由 Android 系统 , 根 
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据 Intent 的 动作 和 数据 来 决定 启动 哪 一 个 Activity。 也 就 是 说 在 隐 式 启动 时 ,Intent 中 
只 包含 需要 执行 的 动作 和 所 包含 的 数据 ,而 无 需 指 明 具 体 启 动 哪 一 个 Activity, 选 择 权 由 
Android 系统 和 最 终 用 户 来 决定 。 


1. 显 式 启 动 


使 用 Intent 来 显 式 启动 Activity, 首 先 需 要 创建 一 个 Intent, 并 为 它 指定 当前 的 应 用 
程序 上 下 文 以 及 要 启动 的 Activity, 把 创建 好 的 这 个 Intent 作为 参数 传递 给 startActivity() 
方法 。 

1 Intent intent= new Intent (IntentDemo.this, ActivityToStart.class) ; 

2 startActivity (intent) ; 


下 面 用 IntentDemo 示例 说 明 如 何 使 用 Intent 启动 新 的 Activity, IntentDemo 示例 

LPI Activity 类 ,分 别 是 IntentDemo 和 ActivityToStart。 程 序 启动 是 默认 启动 

IntentDemo 这 个 Activity, 在 用 户 单 击 “ 启 动 Activity” 按 钮 后 ,程序 启动 ActivityToStart 
这 个 Activity, 如 图 6. 1 所 示 。 


n DME 5:37am 


IntentDemo IntentDemo 


(a) IntentDemo Activity (b) ActivityToStart Activity 


6.1 IntentDemo 示例 用 户 界面 


在 IntentDemo 示例 中 使 用 了 两 个 Activity, 因 此 需要 在 AndroidManifest. xml 文件 
中 注册 这 两 个 Activity. EM Activity I fii H —activity ^ br Ré ZE TE application? th 
签 内 部 。 

AndroidManifest. xml 文件 代码 如 下 : 


1 <?xml version- "1.0"encoding= "utf- 8"?» 

2 «manifest xmlns:android- "http: //schemas .android.cam/apk/res/android" 

3 package- "edu.hrbeu. IntentDemo" 

4 android:versionCode- "1" 

5 android:versionName- "1.0" 

6 < agplicaticn android:ioon- "8 drawable/icon"android: label= "@ string/ago name"? 
了 <activity android:name- ".IntentDemo" 

8 android:label- "e string/app name" 

9 < intent- filter? 

10 < action android:name- "android. intent .action.MAIN"/> 

1 < category android:name- "android. intent .category.LAUNCHER"/> 
12 < /intent- filter 
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13 < /activity> 
14 «activity android:name- ".ActivityToStart" 
15 android:label- "6 string/app name" 
16 < /activity» 

17 € /application» 

18 < uses- sdk android:minSdkVersion- "3"/> 


19  «/manifest^ 


Android 应 用 程序 中 ,用 户 使 用 的 每 个 组 件 都 必须 在 AndroidManifest. xml 文件 中 
节点 内 定义 。 在 上 面 的 代码 中 ,过 application 过 节点 下 共有 两 个 
< 一 activity 过 节点 ,分 别 代 表 应 用 程序 中 所 使 用 的 两 个 Activity, 即 IntentDemo 和 
Pa 

在 IntentDemo. java 文件 中 ,包含 了 显示 使 用 Intent 启动 Activity 的 核心 代码 : 

1 Button button= (Button) findViewByld (R.id.btn) ; 

2 button.setOnClickListener (new OnClickListener () { 

3 public void onClick (View view) { 

4 Intent intent- new Intent (IntentDemo.this, ActivityToStart.class) ; 

5 startActivity (intent) ; 
6 
7 


n; 


点 点 击 事件 的 处 理 函 数 中 ,Intent 构造 函数 的 第 1 个 参数 是 应 用 程序 上 下 文 ,程序 中 
i IntentDemo; 第 2 个 参数 是 接收 Intent 的 目标 组 件 , 使 用 的 是 显 
式 启动 方式 ,直接 指明 了 需要 启动 的 Activity。 


2. 隐 式 启动 


隐 式 启动 的 好 处 在 于 不 需要 指明 启动 哪 一 个 Activity. 而 由 Android 系统 来 决 
定 , 这 样 有 利于 使 用 第 三 方 组 件 。 

隐 式 启动 Activity 时 ,Android 系统 在 应 用 程序 运行 时 解析 Intent, 并 根据 一 定 的 规 
则 对 Intent 和 Activity 进行 匹配 ,使 Intent 上 的 动作 .数据 与 Activity 完全 吻合 。 匹 配 
的 Activity 可 以 是 应 用 程序 本 身 的 ,也 可 以 是 Android 系统 内 置 的 ,还 可 以 是 第 三 方 应 用 
程序 提供 的 。 因 此 ,这 种 方式 更 加 强调 了 Android 应 用 程序 中 组 件 的 可 复 用 性 。 

例如 ,用 户 如 果 和 希望 启动 一 个 浏览 器 ,查看 指定 的 网 页 内 容 , 却 不 能 确定 具体 应 该 
启动 哪 一 个 Activity, 此 时 则 可 以 使 用 Intent 的 隐 式 启动 方式 ,由 Android 系统 在 程序 
运行 时 决定 具体 启动 哪 一 个 应 用 程序 的 Activity 来 接收 这 个 Intent。 程 序 开 发 人 员 可 
以 将 浏览 动作 和 Web 地 址 作为 参数 传递 给 Intent. Android 系统 则 通过 匹配 动作 和 数 
据 格式 ,找到 最 适合 于 此 动作 的 组 件 。 在 默认 情况 下 ,Android 系统 会 调用 内 置 的 Web 
浏览 器 o 

ij Intent intent- new Intent (Intent ACTION VIEW, Uri.parse ("http://waw.google.oau") ) ; 

2 startActivity (intent) ; 
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Intent 的 动作 是 Intent. ACTION. VIEW, DIS URI 的 数据 类 型 来 匹配 动作 。 数 据 
部 分 的 URI 是 Web 地 址 ,使 用 Uri. parse(CurlString) 方 法 ,可 以 简单 地 把 一 个 字符 串 解 


释 成 Uri 对 象 。 


Intent 的 语法 如 下 : 


Intent intent- new Intent (Intent ACTION VIEW, Uri.parse(urlString)); 


Intent 构造 函数 的 第 1 个 参数 是 Intent 需要 执行 的 动作 ,Android 系统 支持 的 常见 
动作 字符 串 常 量 可 以 参考 表 6.1。 第 2 个 参数 是 URI, 表 示 需 要 传递 的 数据 。 


动 作 


表 6.1 Intent 常用 动作 
说 明 


ACTION_ANSWER 


打开 接听 电话 的 Activity, 默 认为 Android 内 置 的 拨号 盘 界 面 


ACTION_CALL 


打开 拨号 盘 界面 并 拨打 电话 ,使 用 Uri 中 的 数字 部 分 作为 电话 号 码 


ACTION_DELETE 


打开 一 个 Activity, 对 所 提供 的 数据 进行 删除 操作 


ACTION_DIAL 


打开 内 置 拨号 盘 界 面 , 显 示 Uri 中 提供 的 电话 号 码 


ACTION_EDIT 


打开 一 个 Activity, 对 所 提供 的 数据 进行 编辑 操作 


ACTION_INSERT 


打开 一 个 Activity, 在 提供 数据 的 当前 位 置 插入 新 项 


ACTION_PICK 


启动 一 个 子 Activity, 从 提供 的 数据 列表 中 选取 一 项 


ACTION_SEARCH 


启动 一 个 Activity, 执 行 搜索 动作 


ACTION_SENDTO 


启动 一 个 Activity, 向 数据 提供 的 联系 人 发 送信 息 


ACTION_SEND 


启动 一 个 可 以 发 送 数据 的 Activity 


ACTION_VIEW 


最 常用 的 动作 ,对 以 Uri 方式 传送 的 数据 ,根据 Uri 协议 部 分 以 最 佳 方 
式 启动 相应 的 Activity 进行 处 理 。 对 于 http:address 将 打开 浏览 器 查 
看 ;对 于 tel:address 将 打开 拨号 呼叫 指定 的 电话 号 码 


ACTION_WEB_SEARCH 


打开 一 个 Activity, 对 提供 的 数据 进行 Web 搜索 


WebViewIntentDemo 示例 说 明了 如 何 隐 式 启动 Activity, 用 户 界 面 如 图 6. 2(a) 


所 示 。 


当 用 户 在 文本 框 中 输入 要 访问 网 址 后 ,通过 单 击 “ 浏 览 此 URL” 按 钮 ,程序 根据 用 户 
输入 的 网 址 生成 一 个 Intent, 并 以 隐 式 启动 的 方式 调用 Android PIER Web 浏览 器 ,并 
打开 指定 的 Web 页 面 。 本 例 输入 的 网 址 是 哈尔滨 工程 大 学 的 主 站 地 址 ,地 址 是 http:// 
www. hrbeu. edu. cn, 打 开 页 面 后 的 效果 如 图 6.2(b) 所 示 。 


612 获取 Activity 返回 值 


在 6.1.1 节 IntentDemo 示例 中 ,通过 使 用 startActivity(Intent) 方 法 启动 Activity. 
启动 后 的 两 个 Activity 之 间 相 互 独立 ,没有 任何 的 关联 。 在 很 多 情况 下 ,后 启动 的 
Activity 是 为 了 让 用 户 对 特定 信息 进行 选择 ,在 关闭 这 个 Activity 后 ,用 户 的 选择 信息 需 
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要 返回 给 未 关闭 的 那个 Activity。 按 照 Activity 启动 的 先后 顺序 , 先 启动 的 称 为 父 
Activity, 后 启动 的 称 为 子 Activity。 如 果 需 要 将 子 Activity 的 部 分 信息 返回 给 父 
Activity, 则 可 以 使 用 Sub-Activity 的 方式 去 启动 子 Activity. 


aE ema 


|WebViewIntentDemo ` www.hrbeu.edu.cn: 哈尔滨 工程 大 学 


http://www.hrbeu.edu.cn| 


(a) 输入 网 址 的 界面 (b) 打开 Web 页 面 后 的 界面 
6.2 WebViewIntentDemo 用 户 界 面 


获取 子 Activity 的 返回 值 ,一 般 可 以 分 为 以 下 三 个 步骤 ， 
(1) 以 Sub-Activity 的 方式 启动 子 Activity。 

(2) 设置 子 Activity 的 返回 值 。 

(3) 在 父 Activity 中 获取 返回 值 。 

下 面 详细 介绍 每 一 个 步骤 的 过 程 和 代码 实现 。 


1. 以 Sub-Activity 的 方式 启动 子 Activity 


以 Sub-Activity 方式 启动 子 Activity, 需要 调用 startActivityForResult (Intent, 
requestCode) PK MX. BR Intent 用 于 决定 启动 哪个 Activity, 参 数 requestCode 是 唯一 的 
标识 子 Activity 的 请 求 码 。 因 为 所 有 子 Activity 返回 时 , 父 Activity 都 调用 相同 的 处 理 
函数 ,因此 父 Activity 使 用 requestCode 来 确定 是 哪 一 个 子 Activity 的 返回 值 。 

显 式 启动 子 Activity 的 代码 如 下 : 


1 int SUBACTIVITY1= 1; 
2 Intent intent=new Intent (this, SubActivityl.class) ; 
3 startActivityForResult (intent, SUBACTIVITY1) ; 


隐 式 启动 子 Activity 的 代码 如 下 : 


1 int SUBACTIVITY2= 2; 
2 Uri uri= Uri .parse ("content ://contacts/people") ; 
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3 Intent intent- new Intent (Intent ACTION PICK, uri); 
4 startActivityForResult (intent, SUBACTIVITY2) ; 


2. REF Activity 的 返回 值 


在 子 Activity 调用 finish() 函 数 关 闭 前 ,调用 setResult() 函 数 将 所 需 的 数据 返回 给 
SÈ Activity。setResult() 函 数 有 两 个 参数 ,一 个 是 结果 码 ,一 个 是 返回 值 。 结 果 码 表明 了 
F Activity 的 返回 状态 ,通常 为 Activity. RESULT_OK 或 者 Activity. RESULT _ 
CANCELED, 也 可 以 是 自 定义 的 结果 码 ,结果 码 均 为 整数 类 型 。 返 回 值 封装 在 Intent 
中 ,也 就 是 说 子 Activity 通过 Intent 将 需要 返回 的 数据 传递 给 父 Activity。 数 据 主要 以 
Uri 形式 提供 的 返回 给 父 Activity, 此 外 还 可 以 附加 一 些 额 外 信息 ,这 些 额外 信息 用 
Extra 的 集合 表示 。 

以 下 代码 说 明 如 何在 子 Activity 中 设置 返回 值 : 
Uri data= Uri .parse ("tel:"+ tel number); 
Intent result- new Intent (null, data); 
result.putExtra ("address", "JD Street"); 
setResult (RESULT CK, result); 
finish(); 


OF WN ro 


3. YES. Activity 中 获取 返回 值 


当 子 Activity 关闭 时 ,启动 它 的 父 Activity 的 onActivityResult O 函数 将 被 调用 。 如 
果 需 要 在 父 Activity 中 处 理子 Activity 的 返回 值 , 则 重 载 此 函数 即 可 。 此 函数 的 语法 
如 下 : 


1 public void onActivityResult (int requestCode, int resultCode, Intent data); 


其 中 第 1 个 参数 requestCode, 用 来 表示 是 哪 一 个 子 Activity 的 返回 值 , 第 2 个 参数 
resultCode 用 于 表示 子 Activity 的 返回 状态 ,第 3 个 参数 data EF Activity 的 返回 数据 ， 
返回 数据 类 型 是 Intent。 根 据 返回 数据 的 用 途 不 同 ,Uri 数据 的 协议 则 不 同 , 也 可 以 使 用 
Extra 方法 返回 一 些 原始 类 型 的 数据 。 

以 下 代码 说 明 如 何在 父 Activity 中 处 理子 Activity 的 返回 值 : 


private static final int SUBACTIVITYI- 1; 
private static final int SUBACTIVITY2=2; 


@ Override 
public void onActivityResult (int requestCode, int resultCode, Intent data) { 
Super .onActivityResult (requestCode, resultCode, data); 
Switch (requestCode) { 
case SUBACTIVITY1: 
if (resultCode ==Activity.RESULT_OK) { 
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10 Uri uriData- data.getData () 

1 Jelse if (resultCode ==Activity.RESULT CANCEL) { 
12 ) 

13 break; 

14 case SUBACTIVITY2: 

15 if (resultCode —— Activity.RESULT OK) { 
16 Uri uriData- data.getData () 7 

17 ) 

18 break; 

19 } 

20 } 


代码 的 第 1 行 和 第 12 行 是 两 个 子 Activity 的 请 求 码 ,在 第 7 行 对 请 求 码 进行 匹配 。 
代码 第 9 行 和 第 11 行 对 结果 码 进行 判断 ,如 果 返 回 的 结果 码 是 Activity. RESULT. OK. 
则 在 代码 的 第 10 行使 用 getData O 函数 获取 Intent 
中 的 Uri 数据 ;如 果 返 回 的 结果 码 是 Activity. 
RESULT_CANCELED, 则 不 进行 任何 操作 。 

ActivityCommunication 示例 说 明了 如 何以 Sub- 
Activity 方式 启动 子 Activity, 以 及 如 何 使 用 Intent 
进行 组 件 间 通信 ,该 示例 的 用 户 界面 如 图 6. 3 所 示 。 

当 用 户 单 击 “ 启 动 Activity1” 和 “启动 Activity2” 
按钮 时 , 程序 将 分 别 启 动 子 SubActivityl 和 
SubActivity2, 如 图 6. 4 所 示 。SubActivityl 提供 了 一 
个 输入 框 ,以 及 “接受 ”和 “撤销 ”两 个 按钮 。 如 果 在 输入 框 中 输入 信息 后 单 击 “接受 ” 按 
钮 ,程序 会 把 输入 框 中 的 信息 传递 给 其 父 Activity, 并 在 父 Activity 的 界面 上 显示 。 而 如 
果 用 户 单 击 “ 撤 销 ” 按 钮 , 则 程序 不 会 向 父 Activity 传递 任何 信息 。SubActivity2 主要 是 
为 了 说 明 如 何在 父 Activity 中 处 理 多 个 子 Activity, 因 此 仅 提供 了 用 于 关闭 SubActivity2 
的 “关闭 ”按钮 。 


启动 Activity2 


6.3 ActivityCommunication 


用 户 界面 
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ActivityCommunication 


(a) SubActivityl (b) SubActivity2 


图 6.4  ActivityCommunication 的 两 个 子 Activity 


ActivityCommunication 示例 的 文件 结构 如 图 6. 5 所 示 , 父 Activity 的 代码 在 
ActivityCommunication. java 文件 中 ,界面 布局 在 main. xml 中 ;两 个 子 Activity 的 代码 
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分 别 在 SubActivityl. java 和 SubActivity2. java 文件 中 ,界面 布局 分 别 在 subactivityl. xml 和 


subactivity2. xml 中 。 GE ActivityConmuni cation 
eee! PERRY . : e | BOB Android 1.5 
ActivityCommunication. java 文件 的 核心 代码 ELES 
| 回 BB. edu. hrbeu. ActivityCommuni cation 
如 下 : 由 - 国 ActivityCommunication. java 
由 - 国 SubActivityl. java 
is j 由 - 国 Subáctivity2. java 
1 public class ActivityCammmnication extends Activity | BEB gen [Generated Java Files] 
{ EB assets 
Bs res 
2 private static final int SUBACTIVITYI- 1; | | BE real 
| RE layout 
3 private static final int SUBACTIVITY2=2; i | a main. xml 
subactivityl xml 
4 TextView textView; i i [X] subactivity2. xml 
n © values 
5 @ Override 一 加 Anároidllani fest. xnl 
6 public void oCreate ( Bundle saved E default. properties 
InstanceState) { 图 6.5 ActivityCommunication 
7 Super.cnCreate (savedInstanceState) ; 文件 结构 
setContentView (R. layout .main) ; 
9 textView- (TextView) findViewById (R.id.textShow) ; 


0 final Button btnl= (Button) findViewByld (R.id.btn1) ; 
1 final Button btn2- (Button) findViewByld (R.id.btn2) ; 
12 
13 btn1.setOnClickListener (new OnClickListener () ( 
4 public void onClick (View view) { 
15 Intent intent- new Intent @ctivityCamnicatin.this, SubActivityl.class); 
6 startActivityForResult (intent, SUBACTIVITYl); 
7 } 
8 DE 
9 
20 btn2.setOnClickListener (new OnClickListener () ( 
21 public void onClick (View view) { 
2 Intent intent-rew Intent @ctivityCamuication.this, SubActivity2.class) ; 
23 startActivityForResult (intent, SUBACTIVITY2) ; 
24 } 
25 DE 
26 } 
21 
28 @ Override 
29 protected void onActivityResult (int requestCode, int resultCode, Intent data) { 
30 super.onActivityResult (requestCode, resultCode, data); 
3 
32 Switch (requestCode) { 
33 case SUBACTIVITY1: 
34 if (resultCode —— RESULT OK) { 
35 Uri uriData- data.getData () ; 
36 textView.setText (uriData.toString () ) ; 


在 代码 的 第 2 行 和 第 3 行 分 别 定义 了 两 个 子 Activity 的 请 求 码 。 在 代码 的 第 16 fT 
和 第 23 行 以 Sub-Activity 的 方式 分 别 启动 两 个 子 Activity。 代 码 第 29 行 是 子 Activity 
关闭 后 的 返回 值 处 理 函 数 ,其 中 requestCode 是 子 Activity 返回 的 请 求 码 ,应 该 与 第 2 fT 
和 第 3 行 定义 的 两 个 请 求 码 相 匹 配 ;resultCode 是 结果 码 ,在 代码 第 32 行 对 结果 码 进行 
判断 ,如 果 等 于 RESULT_OK ,在 第 35 行 代码 获取 子 Activity 的 返回 值 中 的 数据 ;data 
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是 返回 值 , 子 Activity 需要 返回 的 数据 就 保存 在 data 中 。 
SubActivityl.java 的 核心 代码 如 下 : 


H 
2 
3 
4 
5 
6 
* 
8 
9 


public class SubActivityl extends Activity ( 
@ Override 
public void onCreate (Bundle savedInstanceState) { 


Super .onCreate (savedInstanceState) ; 

setContentView (R. layout . subactivityl) ; 

final EditText editText- (EditText) findViewByld (R.id.edit) ; 
Button btnOK- (Button) findViewById(R.id.btn ok); 

Button btnCancel- (Button) findViewById(R.id.btn_cancel) ; 


btn0K.setOnClickListener (new OnClickListener () { 
public void onClick (View view) { 
String uriString- editText .getText () .toString() ; 
Uri data= Uri .parse (uriString); 
Intent result= new Intent (null, data); 
setResult (RESULT_OK, result); 
finish (); 


H 


btnCancel .setOnClickListener (new OnClickListener () { 
public void onClick (View view) { 
setResult (RESULT CANCELED, null); 
finish; 
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代码 第 13 行将 EditText 控件 的 内 容 作为 数据 保存 在 Uri 中 ,并 在 第 14 行 代码 中 使 
用 这 个 Uri £335 Intent. fE 55 15 行 代码 中 ,将 Intent 作为 返回 值 ,RESUIT_OK 作为 结果 
m ,通过 调用 setResult() 函 数 , 将 返回 值 和 结果 码 传 递 给 父 Activity。 最 后 在 代码 第 16 
行 调用 finish O 函数 关闭 当前 的 子 Activity. 

SubActivity2. java 的 核心 代码 如 下 : 


1 public class SubActivity2 extends Activity { 

2 @ Override 

3 public void onCreate (Bundle savedInstanceState) { 

4 super .onCreate (savedInstanceState) ; 

5 setContentView (R. layout .subactivity2) ; 

6 

7 Button btnReturn= (Button)findViewById(R.id.btn return); 
8 btnReturn.setOnClickListener (new OnClickListener () ( 
9 public void onClick (View view) { 

10 setResult (RESULT CANCEIED, null); 

11 finish (); 

12 } 

13 n 

14 } 

15 3 


在 SubActivity2 salina 第 10 行 的 setResult© 函数 仅 设置 了 结果 码 , 第 2 个 参数 
为 null ,表示 数据 需要 传递 给 父 Activity。 


62 Intent zL 2€ SS 


在 隐 式 启动 Activity 时 ,并 没有 在 Intent 中 指明 Activity 所 在 的 类 ,因此 ,Android 
一 定 存 在 某 种 匹配 机 制 ,使 Android 系统 能 够 根据 在 Intent 中 的 数据 信息 ,找到 需要 启 
BHM Activity。 这 种 匹配 机 制 的 实现 就 靠 Android 系统 中 的 Intent 过 滤器 (Intent 
Filter) 实 现 的 。 
Intent 过 滤器 是 一 种 根据 Intent 中 的 动作 (Action) ,# Hl (Categorie) Fil A HR (Data) 
等 内 容 , 对 适合 接收 该 Intent 的 组 件 进 行 匹 配 和 筛选 的 机 制 。Intent 过 滤器 还 可 以 匹配 
数据 类 型 .路径 和 协议 ,还 包括 可 以 用 来 确定 多 个 匹配 项 顺序 的 优先 级 (Priority)。 应 用 
程序 的 Activity 组 件 、Service 组 件 和 BroadcastReceiver 都 可 以 注册 Intent YE $6. 3X 
样 ,这些 组 件 在 特定 的 数据 格式 上 则 可 以 产生 相应 的 动作 。 
为 了 使 组 件 能 够 注册 Intent 过 滤器 ,通常 在 AndroidManifest. xml 文件 的 各 个 组 件 
的 节点 下 定义 二 intent-filter 放 节点 ,然后 在 过 intent-filter 记 节点 中 声明 该 组 件 所 支持 的 
2 DER 当然 ,也 可 以 在 程序 代码 中 动态 地 为 组 件 设 置 
Intent të RE. <intent-filter> 15 i 3x Fi — action> pR% , — category > bg ¥ M< data > 
标签 ,分别 用 来 定义 Intent WUE AEA“ HE” "28 WU" RI BHR” |, — intent-filter 15 4 xc 
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持 的 标签 和 属性 说 明 参 考 表 6. 2。 


表 6.2 —intent-filter — Ë zx B tE 


P 签 属 性 说 有明 
NN Se 指定 组 件 所 能 响应 的 动作 ,用 字符 串 表 示 , 通 常 使 
用 Java 类 名 和 包 的 完全 限定 名 构成 

<category> android; category 指定 以 何 种 方式 去 服务 Intent 请 求 的 动作 
Android:host 指定 一 个 有 效 的 主机 名 
android:mimetype 指定 组 件 能 处 理 的 数据 类 型 

<data> android: path 有 效 的 URI 路 径 名 
android: port 主机 的 有 效 端口 号 
android:scheme 所 需要 的 特定 的 协议 


— category > bi 4& HKI 4€. Intent 过 滤器 的 服务 方式 ,每 个 Intent 过 滤器 可 以 定义 
多 个 二 category 过 标签 ,程序 开发 人 员 可 以 使 用 自 定 义 的 类 别 ,或 使 用 Android 系统 提供 
WAH. Android 系统 提供 的 类 别 可 以 参考 表 6. 3。 


表 6.3 Android 系统 提供 的 类 别 


值 说 明 
ALTERNATIVE Intent 数据 默认 动作 的 一 个 可 替换 的 执行 方法 
SELECTED_ALTERNATIVE pe ds di 
BROWSABLE 声明 Activity 可 以 由 浏览 器 启动 
DEFAULT 为 Intent 过 滤器 中 定义 的 数据 提供 默认 动作 
HOME 设备 启动 后 显示 的 第 一 个 Activity 
LAUNCHER 在 应 用 程序 启动 时 首先 被 显示 


AndroidManifest. xml 文件 中 的 每 个 组 件 的 二 intent-filter 二 都 被 解析 成 一 个 Intent 
过 滤器 对 象 。 当 应 用 程序 安装 到 Android 系统 时 ,所 有 的 组 件 和 Intent 过 滤器 都 会 注册 
到 Android 系统 中 。 这 样 ,Android 系统 便 知 道 了 如 何 将 任意 一 个 Intent 请 求 通过 
Intent 过 滤器 映射 到 相应 的 组 件 上 。 

这 种 Intent 到 Intent 过 滤器 的 映射 过 程 称 为 “Intent fe bt”. Intent 解析 可 以 在 所 有 
的 组 件 中 ,找到 一 个 可 以 与 请 求 的 Intent 达成 最 佳 匹配 的 Intent 过 滤器 。Android 系统 
中 Intent 解析 的 匹配 规则 如 下 : 

(D) Android 系统 把 所 有 应 用 程序 包 中 的 Intent 过 滤器 集合 在 一 起 ,形成 一 个 完整 
的 Intent 过 滤器 列表 。 

(2) 在 Intent 与 Intent 过 滤器 进行 匹配 时 .Android 系统 会 将 列表 中 所 有 Intent 过 
滤器 的 “动作 > 和" 类别? 与 Intent 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 都 将 被 过 滤 掉 。 
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没有 指定 “动作 ”的 Intent 过 滤器 可 以 匹配 任何 的 Intent, 但 是 没有 指定 “类 别 ? 的 Intent 
过 滤器 只 能 匹配 没有 类别? 的 Intent. 

(3) 把 Intent 数据 Uri 的 每 个 子 部 与 Intent 过 滤器 的 二 data 二 标签 中 的 属性 进行 匹 
Bic ,如 果 过 data 之 标签 指定 了 协议 .主机 名 、 路 径 名 或 MIME 类 型 ,那么 这 些 属性 都 要 与 
Intent 的 Uri 数据 部 分 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 均 被 过 滤 掉 。 

(4) 如 果 Intent 过 滤器 的 匹配 结果 多 于 一 个 , 则 可 以 根据 在 二 intentrfilter 之 标签 中 
定义 的 优先 级 标签 来 对 Intent 过 滤器 进行 排序 ,优先 级 最 高 的 Intent 过 滤器 将 被 选择 。 

IntentResolutionDemo 示例 说 明了 如 何在 AndroidManifest. xml 文件 中 注册 Intent 
过 滤 器 , 以 及 如 何 设 置 二 intentrfilter 二 节点 属性 来 捕获 指定 的 Intent. 
AndroidManifest. xml 的 完整 代码 如 下 : 


3 <?xml versione "1.0"encoding= "utf- 8"?» 
2 «manifest xmlns:android- "http: //schemas .android.can/apk/res/android" 
3 package= "edu.hrbeu. IntentResolutionDemo" 
4 android:versionCode- "1" 
5 android:versionName- "1.0" 
6 < application android:iccne "@ drawable/icon"android:label- "@ string/app name" 
7 «activity android:name- ".IntentResolutionDemo" 
8 android:label- "0 string/app name" 
9 < intent- filter» 
0 < action android:name- "android.intent.action.MAIN"/» 
1 < category android:name- "android. intent .category.LAUNCHER"/> 
12 < /intent- filter? 
3 < /activity> 
4 <activity android:name= ".ActivityK a 
5 android: label= "@ string/app name" 
6 < intent- filter» 
7 < action android:name- "android.intent.action.VIEW"/» 
18 < category android:name= "android.intent.category.DEFAULT"/» 
19 < data android:scheme- "schemodemo"android:host= "edu.hrbeu"/» 
20 < /intent- filter» 
21 < /activity> 
22 < application» 
23 < uses- sdk android:minSdkVersion- "3"/> 


24 < /manifest> 


在 代码 的 第 7 行 和 第 14 行 分 别 定 义 了 两 个 Activity。 第 9 行 到 第 12 行 是 第 1 个 
Activity 的 Intent 过 滤器 ,动作 是 android. intent. action. MAIN ,类 别 是 android. intent. 
category.LAUNCHER。 由 过 滤器 的 动作 和 类 别 可 知 ,这 个 Activity 是 应 用 程序 启动 后 
显示 的 默认 用 户 界面 。 

第 16 一 20 行 是 第 2 个 Activity 的 Intent 过 滤器 ,过 滤器 的 动作 是 android. intent. 
action. VIEW ,表示 根据 Uri 协议 ,以 最 佳 的 方式 启动 相应 的 Activity; 类 别 是 android. 
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intent. category. DEFAULT, 表 示 数 据 的 默认 动作 ;数据 的 协议 部 分 是 android: scheme = 
"schemodemo" ,数据 的 主机 名 称 部 分 是 android: host — "edu. hrbeu"。 

在 IntentResolutionDemo. java 文件 中 ,定义 了 一 个 Intent 用 来 启动 一 个 新 的 
Activity, 这 个 Intent 与 Activity 设置 的 Intent 过 滤器 是 完全 匹配 的 。 
IntentResolutionDemo. java 文件 中 Intent 实例 化 和 启动 Activity 的 代码 如 下 : 


1 Intet intent=nw Intent (Intent ACTION VIEN, Uri parse ("scharodamo://eduhrbeu/path")); 

2 startActivity (intent) ; 

代码 第 1 行 所 定义 的 Intent ,动作 为 Intent. ACTION. VIEW. 5j Intent 过 滤器 的 动 
lE android. intent. action. VIEW 匹配 ; Uri 是 “schemodemo://edu. hrbeu/path" , H rf iff 
协议 部 分 为 “schemodemo”, 主 机 名 部 分 为 “edu. hrbeu”, 也 与 Intent 过 滤器 定义 的 数据 
要 求 完全 匹配 。 因 此 ,代码 第 1 行 定义 的 Intent. TE Android 系统 与 Intent 过 滤器 列表 进 
行 匹配 时 ,会 与 AndroidManifest. xml 文件 中 ActivityToStart 定义 的 Intent 过 滤器 完全 
匹配 。 
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Intent 的 另 一 种 用 途 是 发 送 广播 消息 。 应 用 程序 和 Android 系统 都 可 以 使 用 Intent 
发 送 广播 消息 ,广播 消息 的 内 容 可 以 是 与 应 用 程序 密切 相关 的 数据 信息 ,也 可 以 是 
Android 的 系统 信息 ,例如 网 络 连接 变化 .电池 电量 变化 ,接收 到 短信 和 系统 设置 变化 等 
等 。 如 果 应 用 程序 注册 了 BroadcastReceiver, 则 可 以 接收 到 指定 的 广播 消息 。 

使 用 Intent 广播 消息 非常 简单 ,只 需 创建 一 个 Intent, 并 调用 sendBroadcast O PR Bi 
就 可 把 Intent 携带 的 消息 广播 出 去 。 但 需要 注意 的 是 ,在 构造 Intent 时 必须 用 一 个 全 局 
唯一 的 字符 串 标识 其 要 执行 的 动作 ,通常 使 用 应 用 程序 包 的 名 称 。 如 果 要 在 Intent 传递 
额外 数据 ,可 以 用 Intent 的 putExtra() 方 法 。 下 面 的 代码 构造 用 于 广播 消息 的 Intent. 
并 添加 了 额外 的 数据 ,然后 调用 sendBroadcast() 发 生 了 广播 消息 : 


String UNIQUE_STRING= "edu. hrbeu.BroadcastReceiverDano"; 
Intent intent=new Intent (UNIQUE_STRING) ; 
intent .putExtra ("keyl", "valuel"); 
intent.putExtra ("key2", "value2") ; 
sendBroadcast (intent) ; 

BroadcastReceiver 用 于 监听 广播 消息 ,可 以 在 AndroidManifest. xml 文件 或 在 代码 
中 注册 一 个 BroadcastReceiver ,并 在 其 中 使 用 Intent 过 滤器 指定 要 处 理 的 广播 消息 。 创 
建 BroadcastReceiver 需 继 承 BroadcastReceiver 类 ,并重 载 onReceive() 方 法 。 示 例 代 码 
如 下 : 
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1 public class MyBroadcastheceiver extends BroadcastReceiver { 
e @ Override 
3 public void onReceive (Context context, Intent intent) { 
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4 //TODO: React to the Intent received. 


注册 BroadcastReceiver 的 应 用 程序 不 需要 一 直 运 行 , 当 Android 系统 接收 到 与 之 匹 

配 的 广播 消息 时 ,会 自动 启动 此 BroadcastReceiver, 因 此 BroadcastReceiver 非常 适合 做 
FG 9:26 am 一 些 资 源 管理 的 工作 。 在 BroadcastReceiver 接收 到 

[EEC 与 之 匹配 的 广播 消息 后 ,onReceive() 方 法 会 被 调用 ， 


rid, 


test message !!!! 


行 关闭 该 组 件 。 


但 onReceive() 方 法 必须 要 在 5 秒 钟 执行 完毕 ,否则 
Android 系统 会 认为 该 组 件 失 去 响应 ,并 提示 用 户 强 


BroadcastReceiverDemo 示例 说 明了 如 何在 应 
用 程序 中 注册 BroadcastReceiver, 并 接收 指定 类 型 
的 广播 消息 。BroadcastReceiverDemo 示例 的 界面 
如 图 6. 6 所 示 , 在 点 击 “ 发 送 广播 消息 ”按钮 后 ， 
EditText 控件 中 内 容 将 以 广播 消息 的 形式 发 送出 
去 ,示例 内 部 的 BroadcastReceiver 将 接收 这 个 广播 


Selen. 消息 ,并 显示 在 用 户 界面 的 下 方 。 


6.6  BroadcastReceiverDemo 主 界面 


BroadcastReceiverDemo. java 文件 中 包含 发 送 


广播 消息 的 代码 ,其 关键 代码 如 下 : 


1 button.setOnClickListener (new OnClickListener () { 

2 public void onClick (View view) { 

3 Intent intent= new Intent ("edu.hrbeu.BroadcastReceiverDemo") ; 
4 intent .putExtra ("message", entryText.getText () .toString()); 
5 sendBroadcast (intent) ; 

6 ) 

7 D 


代码 第 3 行 创建 Intent 时 ,将 edu. hrbeu. BroadcastReceiverDem 作为 识别 广播 消息 


的 字符 串 标识 ,并 在 代码 第 4 行将 添加 了 额外 信息 ， 


sendBroadcast O ARM AIK) HRA 。 


最 后 在 代码 第 5 行 调用 


为 了 能 够 使 应 用 程序 中 的 BroadcastReceiver 接收 指定 的 广播 消息 ,首先 要 在 
AndroidManifest. xml 文件 中 添加 Intent 过 滤器 ,声明 BroadcastReceiver 可 以 接收 的 广 


播 消息 。AndroidManifest. xml 文件 的 完整 代码 如 下 : 


<?xml versione "1.0"encoding= "utf- 8"?» 


package- "edu.hribeu.BroadcastRecei verDemo" 
android:versionCode- "1" 


1 
2 
3 
4 
5 android:versionName- "1.0" 
6 


«manifest xmlns:android- "http://schemas .android.can/apk/res/android" 


< agplicaticn android:iocne "8 drawable/iocn"android:label- "@ string/apgo name"? 


20 
21 
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<activity android:name- ".BroadcastReceiverDano" 
android:label- "6 string/app_name"> 
«X intent- filter» 
< action android:name- "android.intent.action.MAIN"/» 
< category android:name- "android. intent.category.LAUNCHER"/^ 
< fintent- filter» 
< /activity> 
< receiver android:name= ".MyBroadcastReceiver"> 
< intent- filter> 
< action android:name- "edu.hrbeu.BroadcastReceiverDemo"/> 
< /intent- filter» 


€ /receiver> 


< application» 
< uses- sdk android:minSdkVersion- "3"/> 
< /manifest> 


在 代码 的 第 14 prp Bl Y — A — receiver 15 i. TES 15 行 中 声明 了 Intent 过 滤器 
的 动作 为 “edu. hrbeu. BroadcastReceiverDemo” . iX +j BroadcastReceiverDemo. java 文件 
中 Intent 的 动作 相 一 致 ,表明 这 个 BroadcastReceiver 可 以 接收 动作 为 “edu. hrbeu. 
BroadcastReceiverDemo” 的 广播 消息 。 

MyBroadcastReceiver. java 文件 创建 了 一 个 自 定 义 的 BroadcastReceiver, 其 核心 代 


码 如 下 : 


1 
2 
3 
4 
5 
6 
7 


public class MyBroadcastReceiver extends BroadcastReceiver { 
@ Override 
public void onReceive (Context context, Intent intent) { 


String msg= intent .getStringExtra ("message") ; 
Toast .makeText (context, msg, Toast.LENGTH_ SHORT) .show() 7 


代码 第 1 行 首 先 继承 了 BroadcastReceiver 类 ,并 在 第 3 行 重 载 了 onReveive() FR 
数 。 当 接收 到 AndroidManifest. xml 文件 定义 的 广播 消息 后 ,程序 将 自动 调用 
onReveiveO 也 数 。 代 码 第 4 行 通过 调用 getStringExtraO PA. H Intent 中 获取 标识 ; 
message 的 字符 串 数据 ,并 使 用 Toast 将 信息 显示 在 屏幕 上 。 第 5 行 代码 的 Toast 是 一 
个 显示 提示 信息 的 类 ,调用 makeText() 函 数 可 将 提示 信息 短 时 间 的 浮现 在 用 户 界面 之 
上 。makeText() 函 数 的 第 1 个 参数 是 上 下 文 信息 ;第 2 个 参数 是 需要 显示 的 提示 信 
息 ;第 3 个 参数 是 显示 的 时 间 ,Toast. LENGTH_SHORT 表示 短 时 间 显 示 ,Toast. 
LENGTH_LONG 表示 长 时 间 显 示 ; 最 后 调用 show() 方 法 将 提示 信息 实际 显示 在 界面 
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1. 简 述 Intent 的 定义 和 用 途 。 

2. 简 述 Intent 过 滤器 的 定义 和 功能 。 

3. 简 述 Intent 解析 的 匹配 规则 。 

4. 编程 实现 下 述 功能 : 主 界面 上 有 一 个 “登录 ”按钮 , 单 击 “ 登 录 ” 按 钮 后 打开 一 个 新 
的 Activity; 新 的 Activity 上 面 有 输入 用 户 名 和 密码 的 控件 ,在 用 户 关闭 这 个 Activity 
后 ,将 用 户 输入 的 用 户 名 和 密码 传递 到 主 界面 中 。 


Service 是 Android 系统 的 后 台 服 务 组 件 , 适 用 于 开发 无 界面 .长 时 间 运 行 的 应 用 功 
能 。 通 过 本 章 的 学 习 可 以 让 读者 了 解 后 台 服 务 的 基本 原理 ,掌握 进程 内 服务 与 跨 进程 服 
务 的 使 用 方法 ,有 助 于 深入 理解 Android 系统 的 进程 间 通 信 机 制 。 

本 章 学 习 目 标 : 

。 T # Service 的 原理 和 用 途 

。 掌握 进程 内 服务 的 管理 方法 

。 掌握 服务 的 隐 式 启动 和 显 式 启动 方法 

。 了 和 解 线程 的 启动 、 挂 起 和 停止 方法 

。 了 解 跨 线程 的 界面 更 新 方法 

。 掌握 跨 进程 服务 的 绑 定 和 调用 方法 

。 了 解 AIDL 语言 的 用 途 和 语法 


7.1 Senice i 介 


因为 手机 屏幕 尺寸 的 限制 ,通常 情况 下 在 同一 时 刻 仅 有 一 个 应 用 程序 处 于 激活 状 
态 , 并 能 够 显示 在 手机 屏幕 上 。 因 此 ,应 用 程序 需要 一 种 机 制 ,在 没有 用 户 界面 的 情况 
下 ,使 其 能 够 长 时 间 在 后 台 运 行 ,实现 应 用 程序 的 特定 功能 ,并 能 够 处 理事 件 或 更 新 数 
据 。Android 系统 提供 的 Service( 服 务 ) 组 件 ,不 直接 与 用 户 进行 交互 ,并 能 够 长 期 在 后 
台 运 行 。 有 很 多 情况 需要 使 用 Service, 经 常 提 到 的 例子 就 是 MP3 播放 器 ,用 户 需 要 在 关 
闭 播放 器 界面 后 , 仍 能 够 保持 音乐 继续 播放 ,这 就 需要 将 音乐 回放 的 功能 在 Service 组 件 
实现 。 

Service 非常 适用 于 无 需 用 户 干预 , 且 需 要 长 期 运行 的 后 台 功 能 。Service 没有 用 户 
界面 ,有 利于 降低 系统 资源 的 消耗 ,而 且 Service H Activity 具有 更 高 的 优先 级 ,因此 在 
系统 资源 紧张 时 ,Service 不 会 轻易 被 Android 系统 终止 。 即 使 Service 被 系统 终止 ,在 系 
统 资源 恢复 后 Service 也 将 自动 恢复 运行 状态 ,因此 可 以 认为 Service 是 在 系统 中 永久 运 
行 的 组 件 。Service 除了 可 以 实现 后 台 服 务 功 能 ,还 可 以 用 于 进程 间 通信 (Inter Process 
Communication, IPC) ,解决 两 个 不 同 Android 应 用 程序 进程 之 间 的 调用 和 通信 问题 。 

Service 的 生命 周期 比较 简单 , 仅 包 括 全 生命 周期 和 活动 生命 周期 ,还 有 三 个 事件 回 
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调 函 数 , 分 别 是 onCreate() .onStart() 和 onDestroy() ,如 图 7.1 所 示 。 


调用 
Service 上 有 
startService( ) onCreate( ) +=}; onStart( ) onDestroy( ) 3H] Service 
启动 Service 正在 运行 Sch 


图 7.1 Service 生命 周期 


Service 的 生命 周期 从 onCreate() 开 始 到 onDestroy() 结 束 , 在 onCreate() 中 完成 
的 初始 化 工作 ,在 onDestroy() 中 释放 所 有 占用 的 资源 。 活 动 生命 周 期 从 onStart() 

台 , 但 没有 与 之 对 应 的 “停止 ?函数 ,因此 可 以 近似 认为 活动 生命 周期 也 是 以 onDestroy() 
ui Sie 

Service 的 使 用 方式 一 般 有 两 种 ,一 种 是 启动 方式 , 另 一 种 是 绑 定 方式 。 在 启动 方式 
中 ,通过 调用 Context. startService O 启动 Service, 通 过 调用 Context. stopService() 或 
Service. stopSefl() 停 止 Service。 因 此 ,Service 一定 是 由 其 他 的 组 件 启动 的 ,但 停止 过 程 
可 以 通过 其 他 组 件 或 自身 完成 。 在 启动 方式 中 ,启动 Service 的 组 件 不 能 获取 到 Service 
对 象 , 因 此 无 法 调用 Service 中 实现 的 方法 ,也 不 能 获取 Service 中 的 任何 状态 和 数据 信 
息 。 因 此 ,如 果 仅 以 启动 方式 使 用 Service, 这 个 Service 需要 具备 自 管理 的 能 力 , 且 不 需 
要 通过 函数 调用 向 外 部 组 件 提供 数据 或 功能 。 

在 绑 定 方式 中 ,Service 的 使 用 是 通过 服务 链接 (Connection) 实 现 的 ,服务 链接 能 获 
取 Service 的 对 象 , 因 此 绑 定 Service 的 组 件 可 以 调用 Service 中 实现 的 函数 ,或 直接 获取 
Service 中 状态 和 数据 信息 。 使 用 Service 的 组 件 通过 Context. bindService() 建 立 服 务 链 
接 ,通过 Context. unbindService() 停 止 服务 链接 。 如 果 在 绑 定 过程 中 Service 没有 启动 ， 
Context. bindService() 会 自动 启动 Service。 而 且 同 一 个 Service 可 以 绑 定 多 个 服务 链 
接 ,这 样 可 以 同时 为 多 个 不 同 的 组 件 提供 服务 。 

当然 ,这 两 种 使 用 方法 并 不 是 完全 独立 的 ,可 以 某 些 情 况 下 混合 使 用 启动 方式 和 绑 
定 方式 。 还 是 以 MP3 播放 器 为 例 , 在 后 台 工 作 的 Service 通过 Context. startService() 启 
动 某 个 特定 音乐 播放 ,但 在 播放 过 程 中 如 果 用 户 需 要 暂停 音乐 播放 , 则 需要 通过 
Context. bindService() 获 取 服 务 链接 和 Service 对 象 ,进而 通过 调用 Service 的 对 象 中 的 
函数 ,暂停 音乐 播放 过 程 , 并 保存 相关 信息 。 在 这 种 情况 下 , 如 果 调 用 Context. 
stopService() 不 能 停止 Service, 需 要 在 所 有 的 服务 链接 关闭 后 ,Service 才能 真正 的 停止 。 
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721 服务 管理 


服务 管理 主要 指 服务 的 启动 和 停止 ,在 介绍 如 何 启动 和 停止 服务 前 ,首先 说 明 如 何 
在 代码 中 实现 Service, Service 是 一 段 在 后 台 运 行 、 没 有 用 户 界面 的 代码 ,其 最 小 代码 集 
WP: 


1 import android.app.Service; 
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2  4mport android.content Intent; 

3 import android.os.IBinder; 

4 

5 public class RandamService extends Service 
6 @ Override 

7 public IBinder onBind (Intent intent) { 
8 return null; 

9 } 

10 } 


在 上 面 的 代码 中 ,除了 在 第 1 行 到 第 3 行 引入 必要 包 外 , 仅 在 第 5 行 声 明了 
RandomService 继承 了 android. app. Service 类 ,在 第 7 行 到 第 9 行 重 载 了 onBind() PR 
数 。onBind() 函数 是 在 Service 被 绑 定 后 调用 的 函数 ,能 够 返回 Service 的 对 象 ,在 后 面 
的 内 容 中 会 有 详细 的 介绍 。 

这 个 Service 的 最 小 代码 集 并 不 能 完成 任何 实际 的 功能 ,为 了 使 Service 具有 实际 意 
义 ,一 般 需 要 重 载 onCreate() .onStart() 和 onDestroy()。Android 系统 在 创建 Service 
时 ,会 自动 调用 onCreateO ,用 户 一 般 在 onCreate() 完 成 必要 的 初始 化 工作 ,例如 创建 线 
FE .建立 数据 库 链接 等 。 在 Service 没有 必要 再 存在 时 ,系统 会 自动 调用 onDestroyO ,用 
户 在 onDestroy() 释 放 所 有 占用 的 资源 。 通 过 Context. startServiceCIntent) EI JJ Service 
时 ,onStart() 则 会 被 系统 调用 ,Intent 会 传递 给 Service 一 些 重要 的 参数 。 当 然 , 不 是 所 
有 的 Service 都 需要 重 载 这 三 个 函数 ,完全 可 以 根据 实际 情况 选择 需要 重 载 的 某 个 函数 。 


1 public class RandarService extends Service( 
2 @ Override 

3 public void onCreate() { 

4 super .onCreate () ; 

5 } 

6 @ Override 

7 public void onStart (Intent intent, int startId) { 
8 super.onStart (intent, startId); 
9 ) 

10 @ Override 

u Public void onDestroy() { 

12 super.anDestroy()7 

13 } 

14 } 


AX onCreate() .onStart() 和 onDestroy O =“ PR BLA . 4 4 BE FE (C t p 3] H 42 BR 
数 , 如 代码 的 第 4 行 .第 8 行 和 第 12 行 。 

完成 Service 类 后 ,需要 在 AndroidManifest. xml 文件 中 注册 这 个 Service。 这 个 注 
册 过 程 非常 重要 ,如 果 用 户 不 注册 , 则 这 个 Service 根本 无 法 启动 。AndroidManifest. 
xml 文件 中 注册 Service 的 代码 如 下 : 


1 < service android:name- ".RandanService"/> 
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使 用 二 service 二 标签 声明 服务 ,其 中 的 android: name 表示 的 是 Service 的 类 名 称 ,一 
定 要 与 用 户 建立 的 Service 类 名 称 一 致 。 

在 完成 Service 代码 和 注册 后 ,下 一 步 来 说 明 如 何 启动 和 停止 Service。 有 两 种 方法 
启动 Service, 显 式 启动 和 隐 式 启动 。 显 式 启动 需要 在 Intent 中 指明 Service 所 在 的 类 ,并 
调用 startService(Intent) MAUR Service. a fl {CIS WF: 


1 final Intent serviceIntent- new Intent (this, RandamService.class) ; 
2 startService (serviceIntent) ; 


在 上 面 的 代码 中 ,在 Intent 中 指明 了 启动 的 Service 在 RandomSerevice. class 中 。 

隐 式 启动 则 需要 在 注册 Service 时 ,声明 Intent-filter 的 action 属性 。 

1 < service android:name- ".RandanService"> 

2 < intent- filter» 

3 < action android:name- "edu.hrbeu.RandomService" /> 

4 < /intent- filter> 

5 < /service> 

在 隐 式 启动 Service 时 ,需要 设置 Intent 的 action 属性 ,这 样 则 可 以 在 不 声明 Service 
所 在 类 的 情况 下 启动 服务 。 隐 式 启 动 的 代码 如 下 : 

1 final Intent serviceIntent- new Intent () ; 

2 serviceIntent .setAction ("edu.hrbeu.RandanService") ; 


如 果 Service 和 调用 服务 的 组 件 在 同一 个 应 用 程序 中 ,可 以 使 用 显 式 启动 或 隐 式 启 
动 , 显 式 启动 更 加 易于 使 用 , 且 代 码 简洁 。 但 如 果 服 务 和 调用 服务 的 组 件 在 不 同 的 应 用 
程序 中 , 则 只 能 使 用 隐 式 启动 。 

无 论 是 显 式 启动 还 是 隐 式 启动 ,停止 Service 的 方法 都 是 相同 的 ,将 启动 Service 的 
Intent 传递 给 stopService(Intent) 函数 即 可 ,示例 代码 如 下 : 


aM @ 9:04 am 


SimpleRandomserviceDemo 


1 stopService (serviceIntent) ; 


在 调用 startServiceCIntent) 函数 首次 启动 Service 后 ， Dä 
系统 会 先后 调用 onCreate() 和 onStart() ,如 果 再 次 调用 
startService(Intent) PK% , A Zt Wl] (Lda DI onStart O , 而 不 再 
调用 onCreate( )。 在 调用 stopService (Intent) PR 2X ££ Ik 


startService(Intent) ,在 调用 stopService (Intent) pA SUD. A 
统 仅 调用 onDestroy() 一 次 。 

SimpleRandomServiceDemo 是 在 应 用 程序 中 建立 
Service ,并 以 显 式 启动 服务 的 示例 。 在 工程 中 创建 了 
RandomService 服务 ,该 服务 启动 后 会 产生 一 个 随机 数 ， 图 7.2 SimpleRandomService- 
并 使 用 Toast 显示 在 屏幕 上 ,如 图 7.2 所 示 。 Demo 用 户 界 面 


随机 数 : 0.4284104053214395 


E 后 台 服 务 ES 


在 界面 上 “启动 Service” 按 钮 调用 startService( Intent) PR Zt. JA z/j RandomService DR 
务 。“ 停 止 Service” 按 钮 调用 stopService(Intent) 函数 ,停止 RandomService 服务 。 为 了 
能 够 清晰 地 观察 Service 中 onCreate() .onStart() 和 onDestroy() 三 个 函数 的 调用 顺序 ， 
在 每 个 函数 都 中 使 用 Toast, 在 界面 上 产生 提示 信息 。 

RandomService. java 文件 的 代码 如 下 : 


1 package edu.hrbeu.SimpleRandamServi ceDamo; 
2 
3 import android.app.Service; 
4 import android.content.Intent; 
5 import android.os.IBinder; 
6 import android.widget.Toast; 
y 
8 public class Randcmservice extends Service( 
9 
0 @ Override 
1 public void onCreate() { 
12 super .onCreate () ; 
3 Toast .makeText (this, "(1) 调用 onCreate()", 
4 Toast .LENGTH_LONG) .show() ; 
5 } 
6 
7 @ Override 
8 public void onStart (Intent intent, int startId) { 
9 super.onStart (intent, startId) ; 
20 Toast .makeText (this, "(2) 调用 onStart ()", 
21 Toast .LENGTH_SHORT) .show() ; 
22 
23 double randamDouble= Math.randam(); 
24 String msg- "随机 数 : "+ String. valueOf (randamDouble) ; 
25 Toast .makeText (this,msg, Toast.IENGIH SHORT) .show(); 
26 } 
27 
28 @ Override 
29 public void onDestroy() { 
30 super onDestroy () ; 
31 Toast .makeText (this, "(3) 调用 onDestroy()", 
3 Toast.IENGTH SHORT) .show (); 
38 } 
34 
35 @ Override 
36 public Binder onBind (Intent intent) { 
37 return null; 
38 } 
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在 onStart() 函 数 中 添加 生产 随机 数 的 代码 ,第 23 行 生 产 一 个 介 于 0 一 1 之 间 的 随机 
数 , 并 在 第 24 行 构造 供 Toast 显示 的 消息 。 
AndroidManifest. xml 文件 的 代码 如 下 : 


1 <?xml version- "1.0" encoding- "utf- 8"?> 
2 <manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 
3 package- "edu .hrbeu. SimpleRandarServicsDano" 
4 android:versionCode= "1" 
5 android:versionName- "1.0"> 
6 < application android: icon= "@ drawable/icon" 
android:label- "@ string/app name" 
y < activity android:name- ".SimpleRandamServi. " 
8 android:label- "@ string/app name" 
9 < intent- filter» 
0 « action android:name- "android.intent.action.MAIN" /> 
1 < category android:nare= "android.intent.category.LAUNCHER" /> 
12 < /intent- filter? 
3 < /activity> 
4 < service android:name- ".RandamService"/> 
5 < /application> 
6 < uses- sdk android:minSdkVersion- "3" /> 
7 — «/menifest^ 


在 调用 AndroidManifest. xml 文件 中 ,在 二 application 二 标签 下 «£125 — A — activity > 
标签 和 一 个 二 service 二 标签 ,在 二 service 二 标签 中 ,声明 了 RandomService 所 在 的 类 。 
SimpleRandomServiceDemo. java 文件 的 代码 如 下 : 


2 package edu .hrbeu.SimpleRandamServiceDamo; 

2 

3 import android.app.Activity; 

4 import android.content.Intent; 

5 import android.os.Bundle; 

6 import android.view.View; 

% import android.widget .Button; 

8 

9 public class SimpleRandarServiceDamo extends Activity { 
10 @ Override 

ila: public void onCreate (Bundle savedInstanceState) { 
12 super.onCreate (savedInstanceState) ; 

13 setContentView (R. layout .main) ; 

14 

15 Button startButton- (Button) findViewByld (R.id.start) ; 


16 Button stopButton= (Button) findViewByld (R.id.stop) ; 
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17 final Intent serviceIntent- new Intent (this, RandomService.class) ; 
18 startButton.setOnClickListener (new Button.OnClickListener () { 
19 public void onClick (View view) ( 

20 startService (serviceIntent) ; 

St } 

22 H; 

23 stopButton.setOnClickListener (new Button.OnClickListener () { 
24 public void onClick (View view) { 

25 stopService (serviceIntent) ; 

26 } 

21 n 

28 } 

29-, y 


SimpleRandomServiceDemo. java 文件 是 应 用 程序 中 的 Activity 代码 ,第 20 行 和 第 
25 行 分 别 是 启动 和 停止 Service 的 代码 。 

下 面 不 再 给 出 隐 式 启动 Service 的 示例 代码 ,请 参考 ImplicityRandomServiceDemo 
示例 。 


722 使 用 线程 


在 Android 系统 中 ,Activity Service 和 BroadcastReceiver 都 是 工作 在 主线 程 上 , 因 
此 任何 耗 时 的 处 理 过 程 都 会 降低 用 户 界面 的 响应 速度 ,甚至 导致 用 户 界面 失去 响应 。 当 
用 户 界 面 失 去 响应 超过 5 秒 钟 ,Android 系统 会 允许 用 户 
强行 关闭 应 用 程序 ,如 图 7. 3 所 示 。 因 此 , 较 好 的 解决 方 | A sony 
法 是 将 耗 时 的 处 理 过 程 转 移 到 子 线程 上 ,这 样 可 以 避免 GE 
负责 界面 更 新 的 主线 程 无 法 处 理 界 面 事件 ,从 而 避免 用 peste seat 
户 界面 长 时 间 失 去 响应 。 耗 时 的 处 理 过 程 除 了 指 运算 量 | Force ose | wat | 
巨大 的 复杂 运算 外 ,还 包括 大 量 的 文件 操作 、 网 络 操作 和 
数据 库 操作 等 等 。 

线程 是 独立 的 程序 单元 ,多 个 线程 可 以 并 行 工 作 。 在 多 处 理 器 系统 中 ,每 个 中 央 处 
理 右 (CPU) 单 独 运行 一 个 线程 ,因此 线程 是 并 行 工 作 的 。 但 在 单 处 理 器 系统 中 ,处 理 器 
会 给 每 个 线程 一 小 段 时 间 ,在 这 个 时 间 内 线程 是 被 执行 的 ,然后 处 理 器 执行 下 一 个 线程 ， 
这 样 就 产生 了 线程 并 行 运行 的 假象 。 无 论 线程 是 否 真 的 并 行 工 作 ,在 宏观 上 可 以 认为 子 
线程 是 独立 于 主线 程 , 且 能 与 主线 程 并 行 工作 的 程序 单元 。 

在 Java 语言 中 ,建立 和 使 用 线程 比较 简单 ,首先 需要 实现 Java 的 Runnable 接口 ,并 
ER run() 方 法 。 在 run() 中 放置 代码 的 主体 部 分 。 


7.3 失去 响应 时 的 提示 信息 


private Runnable backgroudWork- new Runnable () { 
@ Override 
public void run() { 


1 
2 
3 
4 // 过 程 代 码 
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dans 


5 } 

6 F 

然后 创建 Thread 对 象 ,并 将 上 面 实现 的 Runnable 对 象 作 为 参数 传递 给 Thread 对 
Z. Thread 的 构造 函数 中 ,第 1 个 参数 用 来 表示 线程 组 ,第 2 个 参数 是 需要 执行 的 
Runnable 对 象 ,第 3 个 参数 是 线程 的 名 称 。 


1 private Thread workThread; 
2 workThread- new Thread (null,backgroudWork, "WorkThread") ; 


最 后 ,调用 start() 方 法 启动 线程 。 
1 workThread. start () ; 


当 线程 在 run() 方 法 返回 后 ,线程 就 自动 终止 了 。 当 然 , 也 可 以 调用 stop() 方 法 在 外 
部 终止 线程 ,但 这 种 方法 并 不 推荐 使 用 ,因为 这 方法 并 不 安全 ,有 可 能 会 产生 异常 。 最 好 
的 方法 是 通知 线程 自行 终止 ,一般 调用 interrupt() 方 法 通告 线程 准备 终止 ,线程 会 释放 
它 正在 使 用 的 资源 ,在 完成 所 有 的 清理 工作 后 自行 关闭 。 


1 workThread. interrupt () ; 


其 实 interrupt() 方 法 并 不 能 直接 终止 线程 , 仅 是 改变 了 线程 内 部 的 一 个 布尔 字段 ， 
run() 方 法 能 够 检测 到 这 个 布尔 字段 ,从 而 知道 何 时 应 该 释放 资源 和 终止 线程 。 在 runO 
方法 的 代码 ,一般 通过 Thread. interrupted() 方 法 查询 线程 是 否 被 中 断 。 在 很 多 情况 下 ， 
子 线程 需要 无 限 运 行 ,除非 外 部 调用 interrupt() 方 法 中 断 线程 ,这 样 一 般 会 将 程序 主体 
放置 在 while() 内 ,并 调用 Thread. interrupted() 方 法 判断 线程 是 否 应 被 中 断 。 下 面 的 代 
码 中 ,以 1 秒 为 间隔 循环 检测 线程 是 否 应 被 中 断 。 


1 public void run() { 

2 while (!Thread.interrupted()) ( 
3 // 过 程 代码 

4 Thread.sleep (1000) ; 

5 

6 


) 


第 4 行 代 码 使 线程 休眠 1000 毫秒 。 当 线程 在 休眠 过 程 中 被 中 断 , 则 会 产生 
InterruptedException。 在 中 断 的 线程 上 调用 sleep C) J; ik. [| FÉ 
InterruptedException。 因 此 除了 使 用 Thread. interrupted ( ) 方 法 判断 线程 是 否 应 被 中 
断 , 还 可 以 通过 捕获 InterruptedException 判断 线程 是 否 应 被 中 断 , 并 且 在 捕获 到 
InterruptedException 后 ,安全 终止 线程 。 


7 public void run() { 

H try { 

2 while (true) { 

3 // 过 程 代码 

4 Thread.sleep (1000) ; 
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} 
} catch (InterruptedException e) { 
e.printStackTrace () 7 
} 
} 


目前 ,读者 已 经 可 以 设计 自己 的 线程 ,但 还 存在 一 个 不 可 回避 的 问题 , 即 在 图 形 用 户 
界面 中 使 用 线程 ,如 何 使 用 线程 中 的 数据 更 新 用 户 界面 。Android 系统 提供 了 多 种 方法 
解决 这 个 问题 ,下 面 仅 介绍 如 何 使 用 Handler 更 新 用 户 界 面 。 

Handler 允许 将 Runnable 对 象 发 送 到 线程 的 消息 队列 中 ,每 个 Handler 对 象 绑 定 到 
一 个 单独 的 线程 和 消息 队列 上 。 当 用 户 建立 一 个 新 的 Handler 对 象 ,通过 post() 方 法 将 
Runnable 对 象 从 后 台 线程 发 送 到 GUI 线程 的 消息 队列 中 , 当 Runnable 对 象 通过 消息 队 
列 后 ,这 个 Runnable 对 象 将 被 运行 。 
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1 private static Handler handler= new Handler () ; 

2 

3 public static void UpdateGUI (double refreshDouble) { 
4 handler.post (RefreshLable) ; 

5 } 

6 private static Runnable RefreshLable= new Runnable () { 
y @ Override 

8 public void run() { 

9 // 过 程 代码 

10 } 

u kẹ 


在 上 面 的 代码 中 ,第 1 行 建立 了 一 个 静态 的 Handler 对 象 ,但 这 个 对 象 是 私有 的 , 因 
此 外 部 代码 并 不 能 直接 调用 这 个 Handler 对 象 。 第 3 FF UpdateGUI() 是 公有 的 界面 更 
新 函数 ,后 台 线程 通过 调用 该 函数 ,将 后 台 产 生 的 数据 refreshDouble 传递 到 UpdateGUI() 
函数 内 部 ,然后 并 直接 调用 post() 方 法 ,将 第 6 行 的 创建 的 Runnable 对 象 传递 给 界面 线 
程 ( 主 线程 ) 的 消息 队列 中 。 第 7 行 到 第 10 行 代码 是 Runnable 对 象 中 需要 重 载 的 run O PRI 
数 ,一 般 将 界面 更 新 代码 放置 在 run PAP 

ThreadRandomServiceDemo 是 使 用 线程 持续 产生 随机 数 的 示例 。 当 用 户 单 击 * 启 动 
Service” 按 钮 后 ,将 启动 后 台 线 程 , 单 击 “ 停 止 Service” 按 钮 后 ,将 关闭 后 台 线 程 。 后 台 线 
Handler 将 产生 的 随机 数 显 示 在 用 户 界 面 上 。 eren 
ThreadRandomServiceDemo 的 用 户 界 面 如 图 7. 4 
所 示 。 

在 ThreadRandomServiceDemo 示 例 中 , Random- Bases, 
Service. java 文件 是 描述 Service 的 文件 ,用 来 创建 线 
程 . 产 生 随 机 数 和 调用 界面 更 新 图 数 。ThreadRan- 图 7.4  ThreadRandomServiceDemo 
domServiceDemo. java 文件 是 界面 的 Activity 文件 ， 用 户 界 面 


启动 Service 
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封装 Handler 的 界面 更 新 图 数 就 在 这 个 文件 中 。 下 面 给 出 RandomService. java 和 
ThreadRandomServiceDemo. java 文件 的 完整 代码 。 
RandomService. java 文件 的 完整 代码 如 下 : 


1 package edu.hrbeu.ThreadRandcmserviceDemp; 
2 
3 import. android.app.Service; 
4 import android.content.. Intent; 
5 import android.os.IBinder; 
6 import android.widget.Toast; 
2 
8 public class RandamService extends Service{ 
9 
0 private Thread workThread; 
1 
12 @ Override 
3 public void onCreate() { 
4 super.onCreate () ; 
5 Toast .makeText (this, "(1) 调用 onCreate()", 
6 Toast .LENGTH_LONG) .show() ; 
H workThread- new Thread (null,backgroudWork, "WorkThread") ; 
8 ) 
9 
20 @ Override 
21 public void onStart (Intent intent, int startId) { 
2 super.onStart (intent, startId); 
23 Toast .makeText (this, "(2) 调用 onstart ()", 
24 Toast .LENGTH_SHORT) .show() ; 
25 if (!workThread.isAlive()) { 
26 workThread.start () ; 
27 } 
28 j 
29 
30 @ Override 
31 public void onDestroy() { 
3 super.onDestroy() ; 
33 Toast.makeText (this, "(3) 调用 onDestroy 0", 
34 Toast .IENGTH SHORT) .show(); 
35 workThread. interrupt () ; 
36 } 
37 
38 @ Override 
39 public [Binder onBind (Intent intent) { 
40 retum null; 
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a } 

42 

43 private Runnable backgroudWork- new Runnable () { 

44 @ Override 

45 public void run() { 

46 try { 

47 while (! Thread. interrupted () ) { 

48 double randamDouble= Math.randam() 7 
49 ThreadRandamServiceDemo..UpdateGUI (randamDouble) ; 
50 Thread. sleep (1000) ; 

51 } 

52 } catch (InterruptedExoeption e) ( 

53 e.printStackTrace () ; 

54 } 

55 } 

56 F 

57 } 


ThreadRandomServiceDemo. java 文件 的 完整 代码 如 下 : 


package edu.hreu.ThreaqdRandcmServiceDempy; 


x 

2 

3 import android.app.Activity; 

4 import android.content. Intent; 
5 import android.os.Bundle; 

6 import android.os.Handler; 

7 import android.view.View; 

8 import android.widget Button; 

9 import android.widget.TextView; 


11 public class ThreadRandamServiceDemo extends Activity { 


13 private static Handler handler- new Handler () ; 

14 private static TextView labelView- null; 

15 private static double randamDouble ; 

16 

17 public static void UpdateGUI (double refreshDouble) ( 
18 randamDouble= refreshDouble; 

19 handler.post (RefreshLable) ; 

20 $ 

21 

22 private static Runnable RefreshLable= new Runnable () { 
23 @ Override 

24 public void run() { 


25 labelView.setText (String.valueOf (randamDouble)) ; 
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26 } 

27 } 

28 

29 @ Override 

30 public void onCreate (Bundle savedInstanceState) { 

31 super .onCreate (savedInstanceState) ; 

32 setContentView (R. layout .main) ; 

33 labelView- (TextView) findViewByld (R.id. label) ; 

34 Button startButton= (Button) findViewByld (R.id.start) ; 

35 Button stopButton= (Button) findViewByTd (R.id.stop) ; 

36 final Intent serviceIntent= new Intent (this, RandomService.class) ; 
37 

38 startButton.setOnClickListener (new Button.OnClickListener () { 
39 public void onClick (View view) { 

40 startService (serviceIntent) ; 

41 } 

42 n; 

43 

44 stopButton.setOnClickListener (new Button.OnClickListener () { 
45 public void onClick (View view) { 

46 stopService (serviceIntent) ; 

47 } 

48 p; 

49 } 

sO} 
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以 绑 定 方式 使 用 Service ,能 够 获取 到 Service 对 象 ,不 仅 能 够 正常 启动 Service. 而 且 
能 够 调用 正在 运行 中 的 Service 实现 的 公有 方法 和 属性 。 为 了 使 Service 支持 绑 定 ,需要 
在 Service 类 中 重 载 onBind() 方 法 ,并 在 onBind() 方 法 中 返回 Service 对 象 , 示 例 代 码 
如 下 : 


public class MathService extends Service{ 
private final [Binder mBinder- new LocalBinder () ; 


1 

2 

3 

4 public class LocalBinder extends Binder( 
5 MathService getService() { 

6 return MathService.this; 

7 

8 

9 


10 @ Override 
1 public IBinder onBind(Intent intent) ( 
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12 return mBinder; 


14 } 


“4 Service 被 绑 定 时 ,系统 会 调用 onBind O ef Zt Hi onBind O PA BAY 3& [nl A. 8 
Service 对 象 返回 给 调用 者 。 但 从 第 11 行 代码 中 可 以 看 出 ,onBind() 函 数 的 返回 值 必须 
是 符合 [Binder 接口 ,因此 在 代码 的 第 2 行 声 明 一 个 接口 变量 mBinder,mBinder 符合 
onBind() 函 数 返 回 值 的 要 求 ,因此 将 mBinder 传递 给 调用 者 。IBinder 是 用 于 进程 内 部 
和 进程 间 过 程 调用 的 轻 量 级 接口 ,定义 了 与 远程 对 象 交互 的 抽象 协议 ,使 用 时 通过 继承 
Binder 的 方法 实现 。 继 承 Binder 的 代码 在 第 4 行 ,LocalBinder 是 继承 Binder 的 一 个 内 
部 类 ,并 在 代码 第 5 行 实现 了 getService O 函数 , 当 调 用 者 获取 到 mBinder 后 ,通过 调用 
getService() 即 可 获取 到 Service 的 对 象 。 

调用 者 通过 bindService () 函数 绑 定 服务 ,并 在 第 1 个 参数 中 将 Intent 传递 给 
bindServiceC) 函数 ,声明 需要 启动 的 Service。 第 3 个 参数 Context. BIND_AUTO_ 
CREATE 表明 只 要 绑 定 存在 ,就 自动 建立 Service; 同时 也 告知 Android 系统 ,这 个 
Service 的 重要 程度 与 调用 者 相同 ,除非 考虑 终止 调用 者 ,否则 不 要 关闭 这 个 Service。 

1 final Intent serviceIntent- new Intent (this,MathService.class) ; 

2 bindService (serviceIntent ,mConnection,Context .BIND AUTO CREATE); 

bindService() pH äi DI 2 个 参数 是 ServiceConnnection。 当 绑 定 成 功 后 ,系统 将 调 
用 ServiceConnnection 的 onServiceConnected() 方 法 ;而 当 绑 定 意 外 断 开 后 ,系统 将 调用 
ServiceConnnection 中 的 onServiceDisconnected 方法 。 因 此 ,以 绑 定 方式 使 用 Service， 
调用 者 需要 声明 一 个 ServiceConnnection ,并 重 载 内 部 的 onServiceConnected () 方 法 和 


onServiceDisconnected 方法 。 


1 private ServiceConnection mConnection= new ServiceConnection() { 

2 @ Override 

3 public void onServioeConnected (ComponentName name, IBinder service) { 
4 mathService- ( (MathService.LocalBinder) service) .getService() ; 

5 } 

6 @ Override 

7 public void onServiceDisconnected (CamponentName name) { 

8 mathService- null; 

9 } 


10 p 


在 代码 的 第 4 行 中 , 绑 定 成 功 后 通过 getService() 获 取 Service 对 象 , 这 样 便 可 以 调 
用 Service 中 的 方法 和 属性 。 代 码 第 8 行将 Service 对 象 设置 为 null ,表示 绑 定 意外 失效 ， 
Service 实例 不 再 可 用 。 

取消 绑 定 仅 需 要 使 用 unbindService ( ) 方 法 ,并 将 ServiceConnnection 传递 给 
unbindService() 方 法 。 但 需要 注意 的 是 ,unbindService() 方 法 成 功 后 ,系统 并 不 会 调用 
onServiceConnected() ,因为 onServiceConnected() 仅 在 意外 断 开 绑 定 时 才 被 调用 。 
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unbindService (mConnection) ; 


绑 定 方式 中 , 当 调 用 者 通过 bindService O 函数 绑 定 Servcie D, onCreate O 函数 和 
onBinde() 函 数 将 先后 被 调用 。 当 调用 者 通过 unbindService() RAUR hE Servcie AY. 
onUnbind() 也 数 将 被 调用 ,如 果 onUnbind() 函 数 的 返回 true, 则 表示 在 新 调用 者 绑 定 服 
务 时 ,onRebind() 男 数 将 被 调用 。 绑 定 方式 的 函数 调用 顺序 如 图 7. 5 所 示 。 


调 


启动 Service 


调 " - 
i i 客户 
E ) onCreate( ) Lei onBind( ) Service Z H 


onUnbind( ) >| onDestroy( ) m: Service 


| 


onRebind( ) 


图 7.5 绑 定 方式 的 函数 调用 顺序 


SimpleMathServiceDemo 是 使 用 绑 定 方式 使 用 Service 的 示例 。 在 示例 中 创建 了 
MathService 服务 ,用 来 完成 简单 的 数学 运算 ,这 里 的 数学 运算 仅 包括 加 法 运算 ,虽然 没 


有 实际 意义 ,但 足以 说 明 如 何 使 用 绑 定 方式 调用 


Service ES 例 中 的 公有 方法 。 在 服务 绑 定 后 ,用 户 SimpleMathServiceDemo 


可 以 单 击 


传递 给 MathService 服务 ,并 从 MathService 对 象 
` 获取 到 加 法 运算 的 结果 ,然后 显示 在 屏幕 的 上 

“取消 绑 定 ”按钮 可 以 解除 与 MathService 的 
pees 在 取消 绑 定 后 ,无 法 通过 “加 法 运算 ” 按 


i“ 加 法 运算 ”按钮 ,将 两 个 随机 产生 的 数值 ES 
服务 绑 定 


钮 获取 加 法 运算 结果 。SimpleMathServiceDemo 7.6 SimpleMathServiceDemo 用 户 界 面 
的 用 户 界面 如 图 7.6 所 示 。 

在 SimpleMathServiceDemo 示例 中 ,MathService. java 文件 是 描述 Service 的 文件 。 
SimpleMathServiceDemo. java 文件 是 界面 的 Activity 文件 , 绑 定 和 取消 绑 定 服务 的 代码 
在 这 个 文件 中 。 下 面 给 出 MathService. java 和 SimpleMathServiceDemo. java 文件 的 完 


整 代码 。 


MathService. java 文件 的 完整 代码 如 下 : 


1 
2 
3 
4 
5 
6 
7 
8 
9 


10 


package edu.hrbeu.SimpleMathServiceDemo; 


import android.app.Service; 
import android.content.Intent; 
import android.os.Binder; 
import android.os.IBinder; 
import android.widget.Toast; 


public class MathService extends Service{ 
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3t private final IBinder mBinder- new LocalBinder () ; 
12 

13 public class LocalBinder extends Binder( 

14 MathService getService() { 

15 return MathService.this; 

16 } 

17 } 

18 

19 @ Override 

20 public IBinder onBind (Intent intent) { 

21 Toast.makeText (this，" 本 地 绑 定 : MathService", 
22 Toast.IENGIH SHORT) .show(); 

23 return mBinder; 

24 } 

2 

26 @ Override 

27 public boolean onUnbind (Intent intent) { 

28 Toast .makeText (this，" 取 消 本 地 绑 定 : MathService", 
29 Toast.IENGTH SHORT) .show() ; 

30 return false; 

31 } 

32 

33 

34 public long Add(long a, long b) { 

35 return at b; 

36 ) 

37 

38 } 


SimpleMathServiceDemo. java 文件 的 完整 代码 如 下 : 


package edu.hrbeu.SimpleMathServioeDemo; 


1 
2 
3 import android.app.Activity; 
4 import android.content .CamponentName; 
5 import android.content .Context; 
6 import android.content.Intent; 
7 import android.content .ServiceConnection; 
8 import android.os.Bundle; 

9 import android.os.IBinder; 

10 import android.view.View; 

11 import android.widget.Button; 

12 import android.widget.TextView; 


14 public class SimpleMathServiceDamo extends Activity { 
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15 private MathService mathService; 

16 private boolean isBound- false; 

17 TextView labelView; 

18 @ Override 

19 public void onCreate (Bundle savedInstanceState) { 

20 Super .onCreate (savedInstanceState) ; 

21 setContentView (R. layout .main) ; 

22 

23 labelView- (TextView) findViewByld (R.id. label) ; 

24 Button bindButton- (Button) findViewById (R.id.bind) ; 

25 Button unbindButton- (Button) findViewByld (R.id-unbind) ; 
26 Button camputButton- (Button) findViewById(R. id.compute) ; 
27 

28 bindButton.setOnClickListener (new View.OnClickListener () { 
29 @ Override 

30 public void onClick (View v) { 

31 if (!isBound) { 

22 final Intent serviceIntent- new Intent (SimpleMath- ServiceDano. this, 


MathService.class); 


33 bindService (serviceIntent,mConnection,Context.BIND AUTO CREATE); 
34 isBound- true; 

35 ) 

36 ) 

37 D 

38 

39 unbindButton.setOnClickListener (new View.OnClickListener () ( 
40 @ Override 

41 public void onClick (View v) { 

42 if (isBound) { 

43 isBound= false; 

44 unbindService (Connection) ; 

45 mathService= null; 

46 } 

47 } 

48 ne 

49 

50 canputButton.setOnClickListener (new View.OnClickListener () { 
51 @ Override 

52 public void onClick (View v) { 

53 if (mathService==nul1) { 

54 label View. setText "RH j£ ARS"); 

55 retum; 

56 I 

E long a= Math. round Math.randam() * 100); 
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58 long b= Math.round Math.randam() * 100); 

59 long result= mathService.Add(a, b); 

60 String msg- String.valueOf (a) - "+ "+ String.valueOf (b)+ 
& "— "4 String. valuef (result) ; 

62 labelView.setText (msg) ; 

63 } 

eA De 

6 } 

66 

67 private ServioeConnection mConnection= new ServiceConnection() { 

68 @ Override 

69 public void onServicsConnected (CanponentNare name, IBinder service) { 

70 mathService- ((MathService.LocalBinder) service) .getService () ; 
7L } 

72 

73 @ Override 

74 public void onServiceDisconnected (CamponentName name) { 

75 mathService= null; 


73 BAER 


731 进程 间 通 信 

在 Android 系统 中 ,每 个 应 用 程序 在 各 自 的 进程 中 和 运行, 而且 出 于 安全 原因 的 考虑 ， 
这 些 进 程 之 间 彼 此 是 隔离 的 ,进程 之 间 传 递 数据 和 对 象 ,需要 使 用 Android 支持 的 进程 
间 通 信 (Inter-Process Communication ,IPC) 机 制 。 在 UNIX/Linux 系统 中 ,传统 的 IPC 
机 制 包括 共享 内 存 .管道 .消息 队列 和 Socket 等 等 ,这 些 IPC 机 制 虽然 被 广泛 使 用 ,但 仍 
然 存 在 着 固有 的 缺陷 ,如 容易 产生 错误 ,难于 维护 等 等 。 在 Android 系统 中 ,没有 使 用 传 
统 的 IPC 机 制 , 而 是 采用 Intent 和 器 进程 服务 的 方式 实现 IPC, 使 应 用 程序 具有 更 好 的 
独立 性 和 健壮 性 。 

Android 系统 允许 应 用 程序 使 用 Intent 使 用 其 他 Activity 和 Service, 同 时 Intent 可 
以 承载 数据 ,是 一 种 极为 简单 高效 , 且 易 于 使 用 的 IPC 机 制 。Android 系统 的 另 一 种 
IPC 机 制 就 是 跨 进 程 服 务 ,服务 和 调用 者 在 不 同 的 两 个 进程 中 ,调用 过 程 需要 跨越 进程 
才能 实现 。 

在 Android 系统 中 使 用 跨 进程 服务 ,一般 按照 以 下 三 个 步骤 实现 。 首 先 ,使 用 AIDL 
语言 定义 跨 进程 服务 的 接口 。 然 后 根据 AIDL 语言 定义 的 接口 ,在 具体 的 Service 类 中 
实现 接口 中 定义 的 方法 和 属性 。 最 后 在 需要 调用 跨 进程 服务 的 组 件 中 ,通过 相同 的 
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AIDL 接口 文件 ,调用 跨 进程 服务 。 
732 服务 创建 与 调用 


在 Android 系统 中 ,不 同 进程 不 能 访问 其 他 进程 的 内 存 控件 ,因此 为 了 使 数据 能 够 
在 不 同 进程 间 传 递 ,数据 必须 转换 成 为 能 够 穿越 进程 边界 的 系统 级 原 语 ,同时 ,在 数据 完 
成 进程 边界 穿越 后 ,还 需要 转换 回 原 有 的 格式 。AIDL (Android Interface Definition 
Language) 是 Android 系统 自 定义 的 接口 描述 语言 ,可 以 简化 进程 间 数 据 格式 转换 和 数 
据 交换 的 代码 ,通过 定义 Service 内 部 的 公共 方法 ,允许 调用 者 和 Service 在 不 同 进程 间 
相互 传递 数据 。AIDL 的 IPC 机 制 与 COM 和 Corba 非常 相似 ,都 是 基于 接口 的 轻 量 级 
进程 通信 和 机制。 

AIDL 语言 的 语法 与 Java 语言 的 接口 定义 非常 相似 ,唯一 不 同 之 处 , AIDL 允许 定义 
函数 参数 的 传递 方向 。AIDL 支持 三 种 方向 : in、out 和 inout, 标 识 为 in 的 参数 将 从 调用 
者 传递 到 跨 进程 服务 中 ,标识 为 out 的 参数 将 从 跨 进 程 服务 传递 到 调用 者 中 ,标识 为 
inout 的 参数 将 先 从 调用 者 传递 到 跨 进程 服务 中 ,再 从 跨 进程 服务 返回 给 调用 者 。 在 不 
标识 参数 的 传递 方向 时 ,默认 认定 所 有 函数 的 传递 方向 为 in。 出 于 性 能 方面 的 考虑 ,不 
要 在 参数 中 标识 不 需要 的 传递 方向 。 

远程 访问 的 创建 和 调用 需要 使 用 AIDL 语言 ,一般 分 为 以 下 几 个 过 程 : 

(1) 使 用 AIDL 语言 定义 跨 进程 服务 的 接口 。 

(2) 通过 继承 Service 类 实现 跨 进程 服务 。 

(3) 绑 定 和 使 用 跨 进 程 服务 。 

下 面 以 RemoteMathServiceDemo 示例 为 参考 ,说 明 如 何 创 建 跨 进 程 服务 。 在 这 个 
示例 中 , 仅 定 义 了 MathService 服务 ,可 以 为 远程 调用 者 提供 加 法 服务 。 


1. 使 用 AIDL 语言 定义 跨 进程 服务 的 接口 
首先 使 用 AIDL 语言 定义 的 MathService 的 服务 接口 ,文件 名 为 IMathService. aidl。 


1 package edu.hrbeu. 9 " ` vl,RWe wr oO 
RemoteMathServiceDamo; ellathServi celeno 
2 interface IMathService ( 
3 long Add (Long a, long b); parie ER 
4 } e" Stub 0. 
@ ? asInterface (Binder) 
从 上 面 的 代码 中 可 以 看 出 ,IMathService 接 2 ures ak Faod, Faci, Get 
口 仅 包含 一 个 add() 方 法 ,传人 的 参数 是 两 个 长 denote ` Binder 
A" Proxy (Binder) 
型 整数 ,返回 值 也 是 长 型 整数 。 $a esBinder 0 o 
©  getInterfacelescriptor 
如 果 使 用 Eclipse 编辑 IMathService. aidl e. MàQong Long) 


BF TRANSACTION Add : int 


文件 , 当 用 户 保 存 文件 后 , ADT 会 自动 在 /gen 9 Mies Lone) 


目录 下 生成 IMathService. java 文件 ,文件 结构 
如 图 7.7 所 示 。 Æ 7.7 IMathService. java 文件 结构 


IMathService. java 文件 根据 IMathService. aid! 的 定义 ,生成 了 一 个 内 部 静态 抽象 类 
Stub.Stub 继承 了 Binder 类 ,并 实现 ImathService 接口 。 在 Stub 类 中 ,还 包含 一 个 重要 
的 静态 类 Proxy. WRUH Stub 类 实现 进程 内 服务 调用 ,那么 Proxy 类 则 是 用 来 实现 跨 
进程 服务 调用 的 ,将 Proxy 作为 Stub 的 内 部 类 完全 是 出 于 使 用 方便 的 目的 。Stub 类 和 
Proxy 类 关系 如 图 7.8 所 示 。 
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AIDL 文件 
IMathService.aidl 


AIDL 


工具 


生成 Java 接 口 文件 


IMathService.java 


生成 内 部 静态 抽象 Stub 类 
IMathService.Stub 


生成 内 部 静态 Proxy 类 
IMathService.Stub.Proxy 


本 地 服务 对 象 


Stub.asInterface( ) 用 来 
返回 远程 服务 对 象 Proxy) 


onTransact( ) 


IMathService.Stub 


IMathService asInterface(IBinder obj) 
IBinder asBinder( ) 

boolean onTransact(int code, Parcel data, 
Parcel reply, int flags) 


远程 服务 对 象 
使 用 asInterface( ) 获 取 


远程 Proxy 对 象 的 引用 


Transact( ) 


IMathService.Stub.Proxy 


IBinder asBinder( ) 
String getInterfaceDescriptor( ) 
long Add(long a, long b) 


7.8 Stub 类 和 Proxy 类 关系 图 


下 面 给 出 IMathService. java 的 完成 代码 : 


import java.lang.String; 

import android.os.RemoteExcgption; 
import android.os. Binder; 

import android.os. interface; 
import android.os.Binder; 

import android.os.Parcel; 


© o A e 0 BF WN PB 


m 
o 


package edu.hrbeu.RemoteMathServiceDemo; 


RemoteMathServioeDemo.IMathService[ 


public interface IMathService extends android.os.lInterface( 
/* * Local- side IPC implementation stub class. * / 
public static abstract class Stub extends android. os. Binder implements edu. hrbeu. 
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1 private static final java. lang. String DESCRIPTOR =" edu. hrbeu. RembteMathServiceDemo. 
TMathService"; 

12 /* * Construct the stub at attach it to the interface. * / 

13 public Stub () ( 

14 this.attachInterface (this, DESCRIPTOR) ; 

15 } 

16 /* * 

17 * Cast an IBinder dbject into an IMathService interface, 

18 * generating a proxy if needed. 

19 */ 

20 public static edu.hrbeu.RemoteMathServiceDem. IMathService asInterface (android.os.IBinder 
obj) { 

2 if ((doj--null)) { 

22 return null; 

23 } 

24 android.os.IInterfaœ iin= (android.os.IInterface) 


œj .queryLocal Interface (DESCRIPTOR) ; 
25 if (((iin!=null) && (iin instanceof edu.hrbeu.RemoteMathServiceDemo. IMathService))) { 


26 return ((edu.hrbeu.RemoteMathServiceDano. IMathService) iin); 

27 } 

28 return new edu. hrbeu.RenoteMathServiosDano. IMathServioe.Stub. Proxy (dbj) ; 

29 } 

30 public android.os.TBinder asBinder () { 

31 return this; 

2 ] 

33 public boolean onTransact (int code, android.os.Parcel data, android.os.Parcel reply, int flags) 


throws android.os.RemoteException( 


34 switch (code) { 

35 case INTERFACE TRANSACTION: 

36 l 

37 reply.writeString (DESCRIPTOR) ; 

38 return true; 

39 } 

40 case TRANSACTION Add: 

41 { 

42 data.enforceInterface (DESCRIPTOR) ; 
43 long _arg0; 

44 _arg0= data.readlong () ; 

45 long _argl; 

46 _argl= data. readiong(); 

47 long _result=this.Add(_arg0, argl); 
48 reply.writeNcException(); 

49 reply.writelong( result); 


50 return true; 
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52 } 

53 retum super.onTransact (code, data, reply, flags); 

a } 

55 private static class Proxy implements edu.hrbeu.RemoteMathServiceDano. IMathService( 
56 private android.os. Binder mRemote; 

57 Proxy (android.os.IBinder remote) { 

58 


mRemote= remote; 
59 } 
60 public android.os.IBinder asBinder () { 
6l retum mRemote; 
62 } 
63 public java.lang.String getInterfaceDescriptor () { 
64 retum DESCRIPTOR; 
65 } 
66 public long Add(long a, long b) throws android.os.RemoteException{ 
67 android.os.Parcel data- android.os.Parcel .dbtain () ; 
68 android.os.Parcel reply- android.os.Parcel.obtain () ; 
69 long result; 
70 try { 
pi . data.writeInterfaceToken (DESCRIPTOR) ; 
72 . data.writelong(a); 
73 . data .writeLong (b) ; 
74 mRemote. transact (Stub. TRANSACTION Add, data, reply, 0); 
75 . reply.readException(); 
76 _result=_reply.readLong () ; 
TI } 
78 finally { 
79 _reply.recycle(); 
80 _data.recycle(); 
81 } 
82 retum _result; 
83 } 
84} 
85 static final int TRANSACTION Add (IBinder.FIRST CALL TRANSACTION+ 0); 
86 } 
87 public long Add(long a, long b) throws android.os.RemoteException; 
88 } 


IMathService 继承 了 android. os. IInterface( 第 8 行 ) ,这 是 所 有 使 用 AIDL 建立 的 接 
口 都 必须 继承 的 基 类 接口 ,这 个 基 类 接口 中 定义 了 asBinder() 方 法 ,用 来 获取 Binder 对 
象 。 在 代码 的 第 30 行 到 第 32 行 , 实 现 了 android. os. Interface 接口 所 定义 的 asBinder() 方 
法 。 在 IMathService 中 , 绝 大 多 数 的 代码 是 用 来 实现 Stub 这 个 抽象 类 的 。 每 个 远程 接 
口 都 包 Stub 类 ,因为 是 内 部 类 ,所 有 并 不 会 产生 命名 的 冲突 。 
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asJInterface(IBinder) 是 Stub 内 部 的 跨 进 程 服务 接口 ,调用 者 可 以 通过 该 方法 获取 到 
跨 进程 服务 的 对 象 。 仔 细 观 察 asInterface(IBinder) 实 现 方法 ,首先 判断 IBinder 对 象 obj 
是 否 为 null( 第 21 行 ), 如 果 是 则 立即 返回 。 然 后 使 用 DESCRIPTOR 构造 android. os. 
Interface 对 象 ( 第 24 行 ) ,并 判断 android. os. [Interface 对 象 是 否 为 进程 内 服务 ,如 果 是 
进程 内 服务 , 则 无 需 进 程 间 通信 ,返回 android. os. Interface 对 象 (第 26 行 ); 如 果 不 是 进 
程 内 服务 , 则 构造 并 返回 Proxy 对 象 (第 28 行 ) 。 

Proxy 内 部 包含 与 IMathService. aidl 相同 签名 的 函数 (第 66 行 ), 并 且 在 该 函数 中 
以 一 定 的 顺序 将 所 有 参数 写 人 Parcel 对 象 ( 第 71 一 76 行 ), 以 供 Stub 内 部 的 onTransact OFF 
法 能 够 正确 获取 到 参数 。 

当 数 据 以 Parcel 对 象 的 形式 传递 到 跨 进程 服务 的 内 部 时 ,onTransact() 方 法 (第 33 
行 ) 将 从 Parcel 对 象 中 逐一 的 读 取 每 个 参数 ,然后 调用 Service 内 部 制定 的 方法 ,并 再 将 
结果 写 人 另 一 个 Parcel 对 象 ,准备 将 这 个 Parcel 对 象 返回 给 远程 的 调用 者 。 

Parcel 是 Android 系统 中 应 用 程序 进程 间 数 据 传 递 的 容器 ,能 够 在 两 个 进程 中 完成 
数据 的 打包 和 拆 包 的 工作 ,但 Parcel 不 同 于 通用 意义 上 的 序列 化 ,Parcel 的 设计 目的 是 
用 于 高 性 能 IPC 传输 ,因此 不 能 将 Parcel 对 象 保存 在 任何 持久 存储 设备 上 。 


2. 通过 继承 Service 类 实现 跨 进程 服务 


IMathService. aidl 是 对 跨 进程 服务 接口 的 定义 ,自动 生成 的 IMathService. java 内 部 
实现 了 跨 进 程 服务 数据 传递 的 相关 方法 ,下 一 步 介绍 如 何 实现 跨 进 程 服 务 。 实 现 跨 进程 
服务 需要 建立 一 个 继承 android. app. Service 的 类 ,并 在 该 类 中 通过 onBind() 方 法 返回 
IBinder 对 象 ,调用 者 使 用 返回 的 [Binder 对 象 就 可 访问 跨 进程 服务 。IBinder 对 象 的 建 
立 通过 使 用 IMathService. java 内 部 的 Stub 类 实现 ,并 逐一 实现 在 IMathService. aidl 接 
口 文件 定义 的 图 数 。 在 RemoteMathServiceDemo 示例 中 , 跨 进 程 服务 的 实现 类 是 
MathService. java, 下 面 是 MathService. java 的 完整 代码 ; 


package edu.hrbeu.RemoteMathServiceDemo; 


1 

2 

3 import android.app.Service; 

4 import android.content.Intent; 
5 import android.os. IBinder; 

6 import android.widget.. Toast; 

? 
8 
9 


public class MathService extends Service{ 
private final IMathService.Stub mBinder- new IMathService.Stub() { 


10 public long Add (long a, long b) { 
u retum atb; 

12 } 

13 H 

14 @ Override 

15 public [Binder onBind(Intent intent) { 


16 Toast makeText (this, "i FEH Æ . MathService", 
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17 Toast .LENGTH SHORT) .show() ; 

18 return mBinder; 

19 } 

20 @ Override 

2 public boolean onUnbind (Intent intent) { 

22 Toast makeText (this，" 取 消 远程 绑 定 : MathService", 
23 Toast.IENGTH SHORT) .show() ; 

24 return false; 

25 } 

26 } 


第 8 行 代 码 表明 MathService 继承 于 android. app. Service. 3 9 行 建 立 
IMathService. Stub 的 对 象 mBinder, 并 在 第 10 行 实现 了 AIDL 文件 定义 的 跨 进 程 服务 
接口 。 第 18 行 在 onBind() 方 法 中 ,将 mBinder 返回 给 远程 调用 者 。 第 16 行 和 第 22 行 
分 别 是 在 绑 定 和 取消 绑 定 时 ,为 用 户 产 生 的 提示 信息 。 BEST 

RemoteMathServiceDemo 示例 的 文件 结构 如 图 7. 9 om eee 


所 示 。 示 例 中 只 有 跨 进程 服务 的 类 文件 MathService, | S E ance 

java 和 接口 文件 IMathService. aidl, 没 有 任何 用 于 启动 p hae 

时 显示 用 户 界面 的 Activity 文件 。 (8 rege E) 
在 调试 RemoteMathServiceDemo 示例 时 ,模拟 器 的 a ER Bes 


屏幕 上 不 会 出 现 用 户 界面 ,但 在 控制 台 会 有 * 没 有 找到 用 CS amait 

于 启动 的 Activity, 仅 将 应 用 程序 同步 到 设备 上 ”的 提示 Brasse 

信息 ,如 图 7. 10 所 示 。 这 些 信息 表明 apk 文件 已 经 上 传 图 7.9 RemoteMathServiceDemo 
到 模拟 器 中 。 =e 


Android Launch! 
adb is running normally. 

No Launcher activity found! 

The launch will only sync the application package on the device! 

Performing sync 

Automatic Target Mode: using existing emulator 'emulator-5554' running compatible 
Uploading RemotelathServiceDemo.apk onto device 'emulator-5554' 

Installing RemoteMathServiceDemo.apk... 

Application already exists. Attempting to re-install instead... 

Success! 

\RemoteMathServiceDemo\bin\RemoteNathServiceDemo.apk installed on device 
Done! 


7.10 RemoteMathServiceDemo 调试 信息 


为 了 进一步 确认 编译 好 的 apk 文件 是 否 正 确 上 传 到 模拟 器 中 ,可 以 使 用 File 
Explorer 查看 模拟 器 的 文件 系统 。 如 果 能 在 /data/app/ 下 找到 edu. hrbeu. 
RemoteMathServiceDemo. apk 文件 ,说 明 提 供 跨 进程 服务 的 apk 文件 已 经 正确 上 传 。 
RemoteMathServiceDemo 示例 无 法 在 Android 模拟 器 的 程序 启动 栏 中 找到 ,只 能 通过 其 
他 应 用 程序 调用 该 示例 中 的 跨 进程 服务 。 图 7. 11 表明 了 edu. hrbeu. Remote- 
MathServiceDemo. apk 文件 的 保存 位 置 。 
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CAE EES: 


Size Date Permiss... 
E (data 2009-06-20 00:53 drwxrwx--x 

DC am 2009-06-20 00:54  drwxrwxrwx 
2009-06-20 


3846 2009-07-07 


drwxrwx—x 


Qi edu. hrbeu. 2009-07-05 09:31 -rw-r-—-r-- 
O edu. hrbeu SinpleRandonServi ceDeno. apk 10004 2008-07-07 02:14 -rw-r--r-- 

E edu. hrbeu. ThreadRandomServi ceDemo. apk 10686 2008-07-07 02:14  -rw-r-—r— 

© app-private 2009-06-20 00:53 drwxrwx--x 

B © dalvik-cache 2009-06-20 00:53 drwxrwx--x 
GC data 2009-06-20 00:53 drwxrwx--x 

国 @ local 2009-06-20 (00:53 drwxrwx--x 
CG lost*found 2009-08-20 00:53  drwxrwx--- 
GS wise 2009-05-20 (00:53 drwxrwx--t 

B © property 2009-06-20 00:53 drwx------ 
© system 2009-08-20 00:54 drwxrwxr-x 

由 (E sdcard 2008-07-07 01:35 én 
8 © system 2009-04-22 04:11 drwxr-xr-x 


7.11 RemoteMathServiceDemo. apk 文件 位 置 


RemoteMathServiceDemo 是 本 书 中 第 一 个 没有 Activity 的 示例 ,在 AndroidManifest. 
xml 文件 中 ,在 二 application 过 标签 下 只 有 一 个 二 service 二 标签 。 
AndroidManifest. xml 文件 的 完整 代码 如 下 : 


<?xml versione "1.0" encoding- "utf- 8"?» 
«mani fest xmlns:android- "http: //schemas android. can/apk/res/android" 
android:versionCode- "1" 
android:versionName- "1.0"» 
< application android:icon- "@ drawable/icon" android:label- "@ string/app name"? 
< service android:name- ".MathService" 
android:process= ":remote"> 
< intent- filter» 
10 < action android:name= "edu .hrbeu.RemoteMathServiceDamo.MathService" /> 
11 < /intent- filter» 


12 < /service» 


o OI DO e Lä H ta 


13 < /application> 

14 « uses- sdk android:minSdkVersion- "3" /> 

15 < /manifest^ 

注意 第 10 fT [V 3. edu. hrbeu. RemoteMathServiceDemo. MathService 是 远程 调用 
MathService 的 标识 ,在 调用 者 段 使 用 Intent. setAction O BOY ERRIA Intent 中 , 然 
后 隐 式 启动 或 绑 定 服务 。 


3. 绑 定 和 使 用 跨 进程 服务 


RemoteMathCallerDemo 示例 说 明 如 何 调用 RemoteMathServiceDemo 示例 中 的 跨 
进程 服务 。RemoteMathCallerDemo 的 界面 如 图 7. 12 所 示 ,用 户 可 以 绑 定 跨 进 程 服 务 ， 
也 可 以 取消 服务 绑 定 。 在 绑 定 跨 进程 服务 后 ,可 以 调用 RemoteMathServiceDemo 中 的 
MathService 服务 进行 加 法 运算 ,运算 的 输入 由 RemoteMathCallerDemo 随机 产生 ,运算 
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的 输入 和 结果 显示 在 屏幕 的 上 方 。 


Bite] RemotellathCallerDemo 
Sé Android 1.5 
B-B sre 
GG ER edu. hrbeu. RenotellathCallerDeno 
由 - 国 RemoteMathCallerDemo. java 
D ame 1:29PM B® : hrbeu RenotellathServi ceDemo 
RemoteMathCallerDemo Bi mathservice aidl 
日 名 gen [Generated Java Files] 
S- edu. hrbeu. RenotellathCallerDeno 
D R java 
SG IB edu. hrbeu. RemoteMathServi ceDemo 
国 INathService. java 
& assets 
DE res 
加 Anároidllani fest. xml 
default. properties 


图 7. 12 RemoteMathCallerDemo 用 户 界 面 7.13 RemoteMathCallerDemo 的 文件 结构 


应 用 程序 在 调用 跨 进程 服务 时 ,应 用 程序 与 跨 进 程 服务 应 具有 相同 的 Proxy 类 和 签 
名 函数 ,这 样 才 能 使 数据 在 调用 者 处 打包 后 ,可 以 在 远程 访问 端正 确 拆 包 , 反 之 亦 然 。 从 
实践 角度 来 讲 , 调用 者 需要 使 用 与 跨 进程 服务 端 相同 的 ADL X fb. 在 
RemoteMathCallerDemo 示例 ,在 edu. hrbeu. RemoteMathServiceDemo 包 下 ,引入 与 
RemoteMathServiceDemo 相同 的 AIDL 文件 IMathService. aidl, 同 时 在 /gen 目录 下 会 自 
动产 生 相 同 的 IMathService. java 文件 。RemoteMathServiceDemo 的 文件 结构 如 图 7. 13 
所 示 。 

RemoteMathCallerDemo. java 是 Activity 的 文件 , 跨 进程 服务 的 绑 定 和 使 用 方法 与 
7.2.3 节 的 进程 内 服务 绑 定 示例 SimpleMathServiceDemo 相似 。 不 同 之 处 主要 包括 以 下 
两 个 方面 ,一 是 使 用 IMathService 声明 跨 进程 服务 对 象 (代码 第 1 行 ); 二 是 通过 
IMathService. Stub 的 asInterface() 方 法 实现 获取 服务 对 象 ( 代 码 第 6 行 )。 


1 private IMathService mathService; 

2 

3 private ServiceConnection mConnection= new ServiceConnection() { 
4 @ Override 

与 public void onServiceConnected (CorponentName name, [Binder service) { 
6 mathService- IMathService.Stub.asInterface (service); 

7 } 

8 @ Override 

9 public void onServiceDisconnected (CamponentName name) { 

10 mathService= null; 

1 ) 


绑 定 服务 时 ,首先 通过 setAction() 方 法 声明 服务 标识 ,然后 调用 bindService O 38 xz 
服务 。 服 务 标识 必须 与 跨 进 程 服务 在 AndroidManifest. xml 文件 中 声明 的 服务 标识 完全 
相同 。 因 此 本 示例 的 服务 标识 为 edu. hrbeu. RemoteMathServiceDemo. MathService, 与 
跨 进 程 服务 示例 RemoteMathServiceDemo 在 AndroidManifest. xml 文件 声明 的 服务 标 
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1 final Intent serviceIntent= new Intent () ; 
2 serviceIntent .setAction ("edu.hrbeu.RemoteMathServiceDemo.MathService") ; 
3 bindService (serviceIntent,mConnection,Context.BIND AUTO CREATE); 


下 面 给 出 RemoteMathCallerDemo. java 文件 的 完整 代码 : 


1 package edu.hrbeu.RemoteMathCallerDano; 
2 
3 import edu.hrbeu.RemoteMathServiceDamo. IMathService; 
4 
5 import android.app.Activity; 
6 import android.content.CoamponentName; 
7 import android.content Context; 
8 import android.content.Intent; 
9 import android.content.ServiceConnection; 
0 import android.os.Bundle; 
1 import android.os.TBinder; 
12 import android.os.RemoteException; 
3 import android.view.View; 
4 import android.widget Button; 
5 import android.widget.TextView; 
6 
7 public class RemoteMathCallerDamo extends Activity ( 
8 private IMathService mathService; 
9 
20 private ServioeConnection mConnection= new ServiceConnection() { 
21 @ Override 
22 public void onServiosConnected (CarponentNare rare, IBinder service) 
23 mathService= IMathService.Stub.asInterface (service); 
24 } 
25 @ Override 
26 public void onServiceDisconnected (CamponentiName name) { 
27 mathService= null; 
28 } 
29 E 


private boolean isBound- false; 

TextView labelView; 

@ Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R. layout main) ; 
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labelView- (TextView) findViewById(R.id.label); 

Button bindButton- (Button) findViewById(R.id.bind) ; 

Button unbindButton= (Button) findViewById(R.id.unbind) ; 
Button camputButton- (Button) findViewById(R.id.campute add); 


bindButton.setOnClickListener (new View.OnClickListener () ( 
@ Override 
public void onClick (View v) { 
if (!isBound) { 

final Intent serviceIntent- new Intent () ; 
servicelntent .setActicn ("eda hrbeu.RemoteMathServiceDano.MathService") ; 
bindService (servicelntent Connection, Context .BIND AUTO CREATE) ; 
isBound= true; 


n; 


unbindButton.setOnClickListener (new View.OnClickListener () ( 
@ Override 
public void onClick (View v) { 
if (isBound) { 
isBound= false; 
unbindService (Connection) ; 
mathService= null; 


n; 


camputButton.setOnClickListener (new View.OnClickListener () ( 
@ Override 
public void onClick (View v) { 
if (mathService== null) { 
labelView.setText ("AR Hp XE E HE FE MR") ; 
retum; 
} 
long a= Math. round Math.random () * 100); 
long b= Math. round Math. randam() * 100); 
long result= 0; 
try { 
result= mathService.Add(a, b); 
} catch (RemoteException e) { 
e.printStackTrace () 7 


dans 
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81 String msg= String.valueOf (a)+ "+ "+ String.valueOf (b)+ 
82 "="+ String. valueOf (result); 
83 labelView.setText (msg) ; 
84 ) 
85 De 
86 } 
87} 

733 数据 传递 


在 Android 系统 中 ,进程 间 传 递 的 数据 包括 Java 语言 支持 的 基本 数据 类 型 和 用 户 自 
定义 的 数据 类 型 ,为 了 使 数据 能 够 穿越 进程 边界 ,所 有 数据 都 必须 是 “可 打包 ?的 。 对 于 
Java 语言 的 基本 数据 类 型 ,打包 过 程 是 自动 完成 的 。 但 对 于 自 定义 的 数据 类 型 ,用 户 则 
需要 实现 Parcelable 接口 ,使 自 定 义 的 数据 类 型 能 够 转换 为 系统 级 原 语 保 存在 Parcel 对 
象 中 ,穿越 进程 边界 后 可 再 转换 为 初始 格式 。AIDL 支持 的 数据 类 型 见 表 7. 1。 


表 7.1 AIDL 支持 的 数据 类 型 


类 型 说 明 需要 引入 
Java 语言 的 基本 类 型 包括 boolean, byte,short,int, float 和 double 等 a 
String java. lang. String a 
CharSequence java. lang. CharSequence 否 
List 其 中 所 有 的 元 素 都 必须 是 AIDL 支持 的 数据 类 型 f 
Map 其 中 所 有 的 键 和 元 素 都 必须 是 AIDL 支持 的 数据 类 型 ^ 
其 他 AIDL 接口 任何 其 他 使 用 AIDL 语言 生成 的 接口 类 型 是 
Parcelable 对 象 实现 Parcelable 接口 的 对 象 是 


下 面 以 ParcelMathServiceDemo 示例 为 参考 ,说 明 如 何在 跨 进 程 服务 中 使 用 自 定 义 
数据 类 型 。 这 个 示例 是 RemoteMathServiceDemo 示例 的 延续 ,也 定义 了 MathService 服 
务 , 同 样 可 以 为 远程 调用 者 提供 加 法 服务 。 而 且 同 样 也 是 没有 启动 界面 .因此 在 模拟 器 
的 调试 过 程 与 RemoteMathServiceDemo 示例 相同 。 

不 同 之 处 在 于 MathService 服务 增加 了 “全 运算 ”功能 ,在 接收 到 输入 参数 后 ,将 向 调 
用 者 返回 一 个 包含 “加 、 减 、 乘 、 除 ”全 部 运算 结果 的 对 象 。 这 个 对 象 是 一 个 自 定义 的 类 ， 
为 了 能 够 使 其 他 AIDL 文件 可 使 用 这 个 自 定义 类 .需要 使 用 AIDL 语言 声明 这 个 类 。 

首先 建立 AllResult. aidl 文件 ,声明 AllResult 类 。 在 第 2 行 代码 中 使 用 Parcelable 
声明 自 定 义 类 , 这样 其 他 的 AIDL 文件 就 可 以 使 用 这 个 自 定义 的 类 。 
ParcelMathServiceDemo 的 文件 结构 如 图 7. 14 所 示 。 


3 package edu.hrbeu. ParcelMathServiceDemo; 
2 parcelable AllResult; 


在 IMathService. aidl 文件 中 ,代码 第 6 行为 全 运算 
增加 了 新 的 函数 ComputeAll() ,该 函数 的 返回 值 就 是 在 
AllResult. aid! 文件 中 定义 的 AllResult。 同 时 ,为 了 能 
够 使 用 自 定义 数据 结构 AllResult, 务 必 在 代码 中 引入 
edu. hrbeu. ParcelMathServiceDemo. AllResult, 98 2 íF 
和 第 6 行 是 新 增 的 代码 ,其 他 的 代码 与 


RemoteMathServiceDemo 示例 相同 。 
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在 AIDL 文件 定义 完毕 后 ,下 一 步 介 绍 如 何 构造 AllResult 类 。AllResult 类 除了 基 
本 的 构造 函数 以 外 ,还 需要 有 以 Parcel 对 象 为 输入 的 构造 函数 ,并 且 需 要 重 载 打 包 函 数 
writeToParcel()。AllResult. java 文件 的 完整 代码 如 下 : 
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package edu .hrbeu. ParcelMathServiceDamo; 


import edu.hrbeu.ParcelMathServiceDano.AllResult; 


interface IMathService { 


long Add (long a, long b); 


AllResult CamputeAll (long a, long b); 


} 


package edu.hrbeu. ParcelMathServiceDemo; 


import android.os.Parcel; 
import android.os.Parcelable; 


public class AllResult implements Parcelable { 


r 


lic long AddResult; 


lic double DivResult; 


AddResult= addRusult; 
SubResult- subResult; 
MilResult-milResult; 
DivResult- divResult; 


public AllResult (Parcel parcel) { 


AddResult= parcel.readLong(); 
SubResult- parcel.readLong() ; 
MülResult- parcel .readLong () ; 
DivResult- parcel.readDouble () ; 
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Ea ES 
SG EB edu hrbeu. ParcelMathServiceDemo 
由 - 国 &11Result. java 
由 - 国 MathService. java 
AllResult. aidl 
一 国 IMathService. aidl 
GB cen [Generated Java Files] 
D DR edu. hrbeu ParcelMathServiceDemo 
由 - 国 IMethService. java 
由 - 国 R java 
GS assets 
BE» res 
@ Androi Meni fest. xnl 
` E default. properties 


7.14 ParcelMathServiceDemo 的 


文件 结构 


lic AllResult (long addRusult, long subResult, long mulResult, double divResult) { 
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25 

26 @ Override 

2] public int describeContents() ( 

28 return 0; 

29 H 

30 

3 @ Override 

2 public void writeToParcel (Parcel dest, int flags) { 
33 dest .writeLong (AddResult) ; 

34 dest .writeLong (SubResult) ; 

35 dest .writeLong MulResult) ; 

36 dest .writeDouble (DivResult) ; 

37 } 

38 

39 public static final Parcelable.Creator< AllResult^ CREATOR= 
40 new Parcelable.Creator< AllResult> () { 

41 public AllResult createFramParcel (Parcel parcel) { 
42 return new AllResult (parcel) ; 

43 } 

44 public AllResult[] newArray (int size) { 

45 return new AllResult [size]; 

46 } 

47 F 

48 } 


代码 第 6 行 说 明了 AllResult 类 继承 于 Parcelable。 代 码 第 7 行 到 第 10 行 用 来 保存 
全 运算 的 运算 结果 。 第 12 行 是 AllResult 类 的 基本 构造 函数 。 第 19 行 也 是 类 的 构造 函 
数 , 支 持 通过 Parcel 对 象 实例 化 AllResult。 代 码 第 32 行 的 writeToParcel O Z& ^47 £2" BR 
数 , 将 AllResult 类 内 部 的 数据 ,按照 特定 的 顺序 写 入 Parcel 对 象 , 写 入 的 顺序 必须 与 构 
造 函 数 的 读 取 顺序 一 致 ( 代 码 第 20 行 到 第 23 行 )。 第 39 行 实现 了 静态 公共 字段 
Creator, 用 来 使 用 Parcel 对 象 构造 AllResult HA. 

在 MathService. java 文件 中 ,增加 了 用 来 进行 全 运算 的 Comput All O 函数 ,并 将 运 
算 结果 保存 在 AllResult 对 象 中 。ComputAll() 函数 实现 代码 如 下 : 

1 @ Override 
2 public AllResult CamputeAll(long a, long b) throws RembteException { 
3 long addRusult- at b; 
4 long subResult- a- b; 
5 long milResult=a * b; 
6 double divResult- (double) a / (double)b; 
T AllResult allResult- new AllResult (addRusult, subResult, milResult, divResult) ; 
8 return allResult; 
9 
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ParcelMathCallerDemo 示例 是 ParcelMathServiceDemo 示例 中 MathService 服务 的 调用 
者 ,文件 结构 如 图 7.15 所 示 。 其 中 ,AllResult aidl, AllResult. java 和 IMathService. aidl 文件 
务必 与 ParcelMathServiceDemo 示例 的 三 个 文件 完全 一 致 ,否则 会 出 现 错误 。 

在 图 7. 16 的 ParcelMathCallerDemo 用 户 界面 中 可 以 看 出 ,原来 的 “加 法 运算 ”按钮 
改 为 了 “全 运算 "按钮 ,运算 结果 显示 在 界面 的 下 方 。 


D Së ParcelMathCallerDemo 
DS Android 1.5 
| BUR sre 
| CG edu. hrbeu. ParcelMathCallerDemo 
由 - 国 ParcelMethCallerDemo. java 
D E edu. hrbeu ParcelMathServiceDemo 
DI AlResult. java 
AllResult. aidl 
D IathService. aidl 
日 名 gen [Generated Java Files] 
| Bef edu hrbeu ParcelMathCallerDemo 


由 - 国 E java 
日 -中 edu. hrbeu. ParcelMathServiceDemo - 
B-f) IMethService. java 
D assets 
| Ge res e 


@ Androi dlani fest. xml 
B default. properties 


7.15  ParcelMathCallerDemo 的 文件 结构 7. 16  ParcelMathCallerDemo 用 户 界 面 


下 面 也 仅 给 出 ParcelMathCallerDemo. java 文件 与 RemoteMathCallerDemo 示例 中 
RemoteMathCallerDemo. java 文件 不 同 的 一 段 代 码 。 定 义 了 “全 运算 ”按钮 的 监听 孔 数 ， 
随机 产生 输入 值 ,调用 跨 进 程 服务 ,获取 运算 结果 ,并 将 运算 结果 显示 在 用 户 界面 上 。 


1 camputAL —Button.setOnClickListener (new View.OnClickListener () { 

2 @ Override 

3 public void onClick (View v) { 

4 if (mathService== null) { 

5 labelView.setText ("未 绑 定 跨 进 程 服务 "); 

6 return; 

7 } 

8 long a= Math. round Math.randam() * 100); 

9 long b= Math. round Math. randam() * 100); 

10 AllResult result- null; 

1 try { 

12 result= mathService.ComputeAll (a, b); 

13 } catch (RemoteException e) { 

14 e.printStackTrace () 7 

15 } 

16 String msg=""; 

17 if (result !=null){ 

18 msg* = String. valueOf (a) + "+ "+ String. valueOf (b) + "— "+ String. valueOf (result. 
AddResult)+ "An"; 

19 msg* = String. valucOf (a) + "- "+ String. valueOf (b) + "— "+ String. valueOf (result. 


SubResult)+ "An"; 
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20 msgt = String.valueof (a)+" * "+ String.valueof (b)+ "= "+ String.valueof (result. 
MilResult)+ "An"; 

21 msg+=String.value0f (a)+" / "+ String.valueOf (b) + "="+ String. valueOf (result. 
DivResult) ; 

22 } 

23 labelView.setText (msg) ; 

24 ) 

2 p 

SI 题 


l. 简 述 Service 的 基本 原理 和 用 途 。 

2. 编程 建立 一 个 简单 的 进程 内 服务 ,实现 比较 两 个 整数 大 小 的 功能 。 服 务 提 供 Int 
Compare(Int, Int) 函数 ,输入 两 个 整数 ,输出 较 大 的 整数 。 

3. 使 用 AIDL 语言 实现 功能 与 第 2 题 相 同 的 跨 进程 服务 。 


数据 存储 与 访问 


Android 平台 提供 多 种 数据 存储 方法 ,包括 易于 使 用 的 SharedPreferences、 经 典 的 文 
件 存储 和 轻 量 级 的 SQLite 数据 库 。 通 过 本 章 的 学 习 , 读 者 可 以 了 解 Android 平台 各 种 
组 件数 据 存储 方法 的 特点 和 使 用 方法 ,掌握 跨 进程 的 数据 共享 方法 。 

本 章 学 习 目 标 : 

。 掌握 SharedPreferences 的 使 用 方法 

。 掌握 各 种 文件 存储 的 区 别 与 适用 情况 

。 了 解 SQLite 数据 库 的 特点 和 体系 结构 

。 掌握 SQLite 数据 库 的 建立 和 操作 方法 

。 理解 ContentProvider 的 用 途 和 原理 

。 掌握 ContentProvider 的 创建 与 使 用 方法 
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在 应 用 程序 的 使 用 过 程 中 ,用 户 经 常会 根据 自己 的 习惯 ,更 改 应 用 程序 的 设置 ,或 设 
定 个 性 化 的 内 容 。 为 了 能 够 保存 用 户 的 设置 和 个 性 化 内 容 , 应 用 程序 一 般 在 文件 系统 中 
保存 一 个 配置 文件 ,并 在 每 次 应 用 程序 启动 时 , 读 取 这 个 配置 文件 中 的 内 容 。 在 文件 系 
统 中 使 用 配置 文件 ,需要 注意 配置 文件 的 格式 ,一 般 使 用 INI 文 件 或 XML 文件 ,当然 也 
可 以 自 定义 文件 格式 。INI 文件 格式 简单 ,容易 读 懂 , 但 需要 写 代码 实现 文件 读 取 和 写 
A. XML 文件 有 成 熟 的 类 支持 ,在 代码 方面 更 容易 实现 ,但 可 读 性 上 要 比 INI 文件 差 一 
些 。 无 论 是 使 用 INI 文 件 , 还 是 使 用 XML 文件 保存 用 户 的 配置 和 个 性 化 内 容 ,程序 的 开 
发 人 员 是 要 进行 繁琐 的 编码 实现 的 。 

Android 为 开发 人 员 提 供 了 更 为 简单 的 数据 存储 方法 SharedPreferences。 这 是 一 种 
轻 量 级 的 数据 保存 方式 ,通过 SharedPreferences 开发 人 员 可 以 将 NVP (Name/ Value 
Pair, 名 称 / 值 对 ) 保 存在 Android 的 文件 系统 中 ,而 且 SharedPreferences 完全 屏蔽 对 文 
件 系统 的 操作 过 程 ,开发 人 员 仅 是 通过 调用 SharedPreferences 对 NVP 进行 保存 和 
ps 
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SharedPreferences 不 仅 能 够 保存 数据 ,还 能 够 实现 不 同 应 用 程序 间 的 数据 共享 。 
SharedPreferences 支持 三 种 访问 模式 : 私有 (MODE_PRIVATE)、 全 局 读 CMODE _ 
WORLD _ READABLE) 和 全 局 写 (MODE | WORLD WRITEABLE)。 如 果 将 
SharedPreferences 定义 为 私有 模式 , 仅 有 创建 程序 有 权限 对 其 进行 读 取 或 写 人 ;如果 将 
SharedPreferences 定义 为 全 局 读 模式 ,不 仅 创建 程序 可 以 对 其 进行 读 取 或 写 人 ,其 他 应 
用 程序 也 读 取 操作 的 权限 ,但 没有 写 入 操作 的 权限 ;如 果 将 SharedPreferences 定义 为 全 
局 写 模 式 , 则 创建 程序 和 其 他 程序 都 可 以 对 其 进行 写 入 操作 ,但 没有 读 取 的 权限 。 

在 使 用 SharedPreferences 前 , 先 定义 SharedPreferences 的 访问 模式 。 下 面 的 代码 
将 访问 模式 定义 为 私有 模式 。 


public static int MODE= MODE PRIVATE; 


有 的 时 候 需 要 将 SharedPreferences 的 访问 模式 设 定 为 既 可 以 全 局 读 , 也 可 以 全 局 
ES ,这样 就 需要 将 两 种 模式 写成 下 面 的 方式 。 


public static int MODE- Context.MODE WORLD READABIEt Context.MDDE WORLD WRITEABLE; 


除了 定义 SharedPreferences 的 访问 模式 ,还 要 定义 SharedPreferences 的 名 称 , 这 个 
名 称 与 在 Android 文件 系统 中 保存 的 文件 同名 。 因 此 ,只 要 具有 相同 的 SharedPreferences 
名 称 的 NVP 内 容 , 都 会 保存 在 同一 个 文件 中 。 


public static final String PREFERENCE NAME- "SaveSetting"; 


为 了 可 以 使 用 SharedPreferences ,需要 将 访问 模式 和 SharedPreferences 名 称 作为 参 
数 ,传递 到 getSharedPreferences() ph M . Ff JK HLH) SharedPreferences 对 象 。 


SharedPreferences sharedPreferences- getSharedPreferences (PREFERENCE NAME, MODE) ; 


在 获取 到 SharedPreferences 对 象 后 , 则 可 以 通过 SharedPreferences. Editor 类 对 
SharedPreferences 进行 修改 ,最 后 调用 commit O PR Zt (t fe fe AANA. SharedPreferences 
广泛 支持 各 种 基本 数据 类 型 ,包括 整 型 .布尔 型 . 浮 点 型 和 长 型 等 等 。 

SharedPreferences.Editor editor= sharedPreferences.edit (); 
editor.putString("Name", "Tam"); 

editor.putInt ("Age", 20); 

editor.putFloat "Height", 1.81f); 

editor.camit (); 

如 果 需 要 从 已 经 保存 的 SharedPreferences 中 读 取 数据 ,同样 是 调用 
getSharedPreferences ( ) pA M&M. 并 在 函数 的 第 1 个 参数 中 指明 需要 访问 的 
SharedPreferences 名 称 ,最 后 通过 get<Type> O AOR PURT Æ SharedPreferences 中 
AY NVP, get<Type> O PARIS 1 个 参数 是 NVP 的 名 称 , 第 2 个 参数 是 在 无 法 获取 到 
数值 的 时 候 使 用 的 默认 值 。 
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1 SharedPreferences sharedPreferences- getSharedPreferences (PREFERENCE NAME, MODE) ; 
2 String name= sharedPreferences.getString ("Name", "Default Name"); 
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3 int age- sharedPreferences.getInt ("Age", 20); 
4 float height= sharedPreferences .getFloat ("Height",1.81f) ; 


812 示例 


在 介绍 了 SharedPreferences 的 使 用 方法 后 ,下 面 将 通过 SimplePreferenceDemo 2 


例 介绍 具体 说 明 SharedPreferences 的 文件 保存 位 置 和 保 G Gwe sam 
存 格式 。SimplePreferenceDemo 示例 的 用 户 界面 如 图 8.1 所 ES 


Toi 


示 ,用户 在 界面 上 的 输入 的 信息 ,将 通过 SharedPreferences 
在 Activity 关闭 时 进行 保存 。 当 应 用 程序 重新 开启 时 , 保 e 
存在 SharedPreferences 的 信息 将 被 读 取出 来 ,并 重新 呈现 
在 用 户 界 面 上 。 

SimplePreferenceDemo 示例 运行 后 ,通过 FileExplorer 查 8.1 SimplePreferenceDemo 
看 /data/data 下 的 数据 ,Android 为 每 个 应 用 程序 建立 了 用 户 界面 
与 包 同 名 的 目录 ,用 来 保存 应 用 程序 产生 的 数据 ,这 些 数据 
包括 文件 .SharedPreferences 文件 和 数据 库 等 。SharedPreferences 文件 就 保存 在 /data/ 
data/<package name>/shared_prefs 目录 下 。 

在 本 示例 中 ,shared_prefs 目录 下 生成 了 一 个 名 为 SaveSetting. xml 的 文件 ,如 图 8.2 所 
示 。 这 个 文件 就 是 保存 SharedPreferences 的 文件 ,文件 大 小 为 170 字 节 ,在 Linux 下 的 
权限 为 *-rw-rw-rw”。 在 Linux 系统 中 ,文件 权限 分 别 描 述 了 创建 者 、 同 组 用 户 和 其 他 用 
户 对 文件 的 操作 限制 。x 表示 可 执行 ,r 表示 可 读 ,w 表示 可 写 ,d 表示 目录 ,- 表 示 普 通 文 
件 。 因 此 ,“-rw-rw-rw” 表 示 SaveSetting. xml 可 以 被 创建 者 、 同 组 用 户 和 其 他 用 户 进 行 
读 取 和 写 入 操作 ,但 不 可 执行 。 产 生 这 样 的 文件 权限 与 程序 人 员 设 定 的 
SharedPreferences 的 访问 模式 有 关 ,“-rw-rw-rw” 的 权限 是 “全 局 读 十 全 局 写 ” 的 结果 。 
如 果 将 SharedPreferences 的 访问 模式 设置 为 私有 , 则 文件 权限 将 成 为 -rw-rw ---”, 表 示 
仅 有 创建 者 和 同 组 用 户 具 有 读 写 文件 的 权限 。 


2009-07-10 02:18 drwxr-xr-x 


i (lib 2009-07-10 02:18  drwxr-xr-x 


E @ shared prefs 2009-07-10 03:01 dee Gg 
B Savesetting xml 170 2009-07-15 08:45 
E G edu hrbeu. SinpleRandonServi ceDeno 2009-06-80 12:17 
& edu. hrbeu SpinnerDemo 2009-06-21 07:01 


图 8.2 SaveSetting. xml 文件 


SaveSetting. xml 文件 是 以 XML 格式 保存 的 信息 ,内 容 如 下 : 


Y <?xml version- '1.0' encoding- 'utf- 8' standalone- 'yes' ?> 
2 «map» 

RT < float name- "Height" value- "1.81" /> 

4 < string name= "Name"> Tax /string> 

5 «int name- "Age" value= "20" /> 

6 — «/mp» 
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SimplePreferenceDemo 示例 在 onStart O eh Zi P i] H loadSharedPreferences() PR RL. 
读 取 保存 在 SharedPreferences P Dik 4 , 4E e RU Er ej fei i. «2f tho (EJH IP Ve BE b. CH 
Activity 关闭 时 ,在 onStopO ER EIC DI saveSharedPreferencesO ,保存 界面 上 的 信息 。 下 
面 给 出 示例 的 完整 代码 。 

SimplePreferenceDemo. java 的 完整 代码 如 下 : 


package edu.hrbeu.SimplePreferenoceDemo; 


import android.app.Activity; 

import android.content .Context; 

import android.content .SharedPreferences; 
import android.os.Bundle; 

import android.widget .EditText; 
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public class SimplePreferenceDem extends Activity ( 


private EditText nameText; 

private EditText ageText; 

private EditText heightText; 

public static final String PREFERENCE NAME- "SaveSetting"; 

public static int MODE- Context.MODE WORLD _READABLE+ Context .MODE WORLD WRITEABLE; 


@ Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 

20 setContentView (R. layout .main) ; 

2 nameText- (EditText) findViewById (R. id.name) ; 

22 ageText- (EditText) findViewById(R.id.age); 

23 heightText- (EditText) findViewByld (R.id-height) ; 
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26 @ Override 

21 public void onStart () { 

28 super .onStart () ; 

29 loadSharedPreferences () ; 

} 

@ Override 

public void onStop() { 
super.onStop () ; 
saveSharedPreferences () ; 


private void loadSharedPreferences () { 
SharedPreferences sharedPreferences= getSharedPreferences (PREFERENCE NAME, MODE); 
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示例 SharePreferenceDemo ¥ i% BH Dt {ay i3 
TE. SharePreferenceDemo 示例 的 用 户 界面 如 图 8. 3 所 5 
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String name- sharedPreferences.getString ("Name", "Tan") ; 
int age= sharedPreferences .get Int ("Age", 20); 
float height= sharedPreferences .getFloat ("Height",1.81£) ; 


nameText .setText (name) ; 
ageText .setText (String. valucOf (age) ) 7 
heightText .setText (String. valueOf (height) ) ; 


private void saveSharedPreferences () { 
SharedPreferences sharedPreferences= getSharedPreferences (PREFERENCE NAME, MODE) ; 
SharedPreferences.Editor editor- sharedPreferences.edit () ; 


editor.putString ("Name", nameText .get Text () -toString()) ; 

editor.putInt ("Age", Integer.parseInt (ageText .get Text () . 

toString())); 

editor.putFloat ("Height", Float.parseFloat (heightText.getText () .toString())) 7 
editor.camit () ; 


取 其 他 应 用 程序 保存 的 SharedPreferences 


ZR ,示例 将 读 取 SimplePreferenceDemo 示例 保存 的 信息 ， ROSS 


并 在 程序 启动 时 显示 在 用 户 界 面 上 。 
下 面 给 出 SharePreferenceDemo 示例 的 核心 代码 : 


1 
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public static final String PREFERENCE PACKAGE- "edu.hrbeu. 8.3 SharePreferenceDemo 
SimplePreferenceDemo"; 

pin RP B 
public static final String PREFERENCE NAME- "SaveSetting"; 


public static int MODE= Context. MODE WORLD READABLE + 
Context.MODE WORLD WRITEABLE; 


public void onCreate (Bundle savedInstanceState) { 


Context c= null; 
try { 
c this.createPackageContext (PREFERENCE PACKAGE, Context CONTEXT IGNORE SECURITY); 
} catch (NameNotFoundException e) { 
e.printStackTrace () ; 
} 
SharedPreferences sharedPreferences= c.getSharedPreferences (PREFERENCE NAME, MODE) ; 
String name- sharedPreferences.getString ("Name", "Tan") ; 
int age- sharedPreferences.getInt ("Age", 20); 
float height= sharedPreferences .getFloat ("Height",1.81f) ; 


{all @ 9:40 AM 
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16 } 


从 上 面 的 代码 中 可 以 看 出 ,第 8 行 代码 调用 了 createPackageContext O 2X IF) T 
SimplePreferenceDemo 示例 的 Context. 1 个 参数 是 SimplePreferenceDemo 的 包 名 称 ， 
在 代码 第 1 行进 行 了 定义 ,第 2 个 参数 Context. CONTEXT_IGNORE_SECURIT 表示 
忽略 所 有 可 能 产生 的 安全 问题 。 这 段 代 码 可 能 引发 异常 ,因此 必须 防止 在 try/catch 中 。 
在 代码 第 12 行 , 通 过 Context 得 到 了 SimplePreferenceDemo 示例 的 SharedPreferences 
对 象 ,同样 在 getSharedPreferences O 函数 中 ,需要 将 正确 的 SharedPreferences 名 称 传递 
给 函数 。 

由 此 可 见 ,访问 其 他 应 用 程序 的 SharedPreferences 必须 满足 三 个 条 件 : (1) 共 享 者 
需要 将 SharedPreferences 的 访问 模式 设置 为 全 局 读 或 全 局 写 ; (2) 访 问 者 需要 知道 共享 
者 的 包 名 称 和 SharedPreferences 的 名 称 ,以 通过 Context 获得 SharedPreferences 对 象 ; 
(3) 访 问 者 需要 确切 知道 每 个 数据 的 名 称 和 数据 类 型 ,用 以 正确 读 取 数据 。 
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虽然 SharedPreferences 能 够 为 程序 开发 人 员 简 化 数据 存储 和 访问 的 过 程 ,但 使 用 文 
件 系统 直接 保存 数据 仍然 是 数据 存储 中 不 可 或 缺 的 重要 组 成 部 分 。Android 使 用 的 是 基 
F Linux 的 文件 系统 ,程序 开发 人 员 可 以 建立 和 访问 程序 自身 的 私有 文件 ,也 可 以 访问 
保存 在 资源 目录 中 的 原始 文件 和 XML 文件 ,还 可 以 在 SD 卡 等 外 部 存储 设备 中 保存 
文件 。 
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Android 系统 允许 应 用 程序 创建 仅 能 够 自身 访问 的 私有 文件 ,文件 保存 在 设备 的 内 
部 存储 器 上 ,在 Linux 系统 下 的 /data/data/ 二 package name>/files 目录 中 。Android 系 
统 不 仅 支持 标准 Java 的 IO 类 和 方法 ,还 提供 了 能 够 简化 读 写 流 式 文件 过 程 的 函数 。 下 
面 主要 介绍 两 个 函数 openFileOutput() 和 openFileInput() 。 

openFileOutput O 函数 为 写 人 数据 做 准备 而 打开 的 应 用 程序 私 文件 ,如 果 指 定 的 文 
件 不 存在 , 则 创建 一 个 新 的 文件 。openFileOutput() 函数 的 语法 格式 如 下 : 


public FileOutputStream openFileOutput (String name, int mode) 

第 1 个 参数 是 文件 名 称 ,这 个 参数 不 可 以 包含 描述 路 径 的 斜 枉 。 第 2 个 参数 是 操作 
模式 ,Android 系统 支持 4 种 文件 操作 模式 ,文件 操作 模式 的 说 明 参 见 表 8. 1。 函 数 的 返 
回 值 是 FileOutputStream 类 型 。 


表 8.1 4 种 文件 操作 模式 
模 x 说 有明 
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私有 模式 ,缺陷 模式 ,文件 仅 能 够 被 文件 创建 程序 访问 ,或 具有 


MODE_PRIVATE 
= 相同 UID 的 程序 访问 


MODE_APPEND 追加 模式 ,如果 文件 已 经 存在 , 则 在 文件 的 结尾 处 添加 新 数据 


MODE_WORLD_READABLE 全 局 读 模式 ,允许 任何 程序 读 取 私有 文件 


MODE_WORLD_WRITEABLE 全 局 写 模式 ,允许 任何 程序 写 入 私有 文件 


使 用 openFileOutput() 函 数 建立 新 文件 的 示例 代码 如 下 : 
String FILE_NAME= "fileDemo.txt"; 

FileOutputStream fos= cpenFileOutput (FILE NAME, Context .MODE PRIVATE) 
String text= "Same data"; 

fos .write (text .getBytes () ) 7 

fos. flush (); 


fos.close(); 


代码 首先 定义 的 建立 文件 的 名 称 fileDemo. txt, 然 后 使 用 openFileOutput O 函数 以 
私有 模式 建立 文件 ,并 调用 write( ) 男 数 将 数据 写 入 文件 ,调用 flush O ROKI A RR KY 
数据 写 入 文件 ,最 后 调用 close O ER COE B]. FileOutputStream。 为 了 提高 文件 系统 的 性 
能 ,一般 调用 write() 函 数 时 ,如 果 写 入 的 数据 量 较 小 ,系统 会 把 数据 保存 在 数据 缓冲 区 
中 ,等 数据 量 累 积 到 一 定 程度 时 再 一 次 性 地 写 入 文件 中 。 因 此 ,在 调用 close O R Ak A 
文件 前 ,务必 要 调用 flush() 函 数 , 将 缓冲 区 内 所 有 的 数据 写 入 文件 。 

openFileInput() 函 数 为 读 取 数 据 做 准备 而 打开 的 应 用 程序 私 文件 。openFileOutput() 
函数 的 语法 格式 如 下 : 


oO 0c fF WN PP 


public FileInputStream openFileInput (String name) 
第 1 个 参数 也 是 文件 名 称 , 同 样 不 允许 包含 描述 路 径 的 斜 枉 。 使 用 openFileInput() 
函数 打开 已 有 文件 的 示例 代码 如 下 : 


String FIE NAME- "fileDemo.txt"; 
FileInputStream fis- openFileInput (FILE NAME) ; 


byte[] readBytes= new byte[fis.available()]; 
while(fis.read(readBytes) !=-1){ 
) 


1 
2 
3 
4 
5 
6 
上 面 的 两 部 分 代码 在 实际 使 用 过 程 中 会 遇 到 错误 提示 ,因为 文件 操作 可 能 会 遇 到 各 

种 问题 而 最 终 导致 操作 失败 ,因此 代码 应 该 使 用 try/catch 捕获 可 能 产生 的 异常 。 
ma QN 2c 在 InternalFileDemo 示例 用 来 演示 在 内 部 存储 
InternalFileDemo We 器 上 进行 文件 写 人 和 读 取 的 示例 。 用 户 界面 如 图 8.4 
BUR ,用 户 将 需要 写 和 人 的 数据 添加 在 EditText 中 , 通 
过 “ 写 入 文件 ”按钮 将 数据 写 入 到 /data/data/edu. 
hrbeu. InternalFileDemo/ files/fileDemo. txt 文件 中 。 

Bienax 
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如 果 用 户 选 择 “ 追 加 模式 ”, 数 据 将 会 添加 到 fileDemo. txt 文件 的 结尾 处 。 通 过 “ 读 取 文 
件 ” 按 钮 ,程序 会 自动 读 取 fileDemo. txt 文件 的 内 容 , 并 显示 在 界面 下 方 的 白色 区 域 中 。 
下 面 给 出 InternalFileDemo 示例 的 核心 代码 : 


OnClickListenerwriteButtonListener- new OnClickListener() { 
@ Override 
public void onClick (View v) { 


FileOutputStream fos= null; 
try { 
if (appendBox.isChecked()){ 
fos= cpenFileOutput(FILE NAME,Context.MODE APPEND) ; 
Jelse { 
fos= qpenFilleOutput (FILE_NAME,Context.MODE PRIVATE); 


} 
String text= entryText .getText () .toString(); 
fos.write (text .getBytes () ) ; 
labelView.setText ("文件 写 人 成 功 , 写 和 长度: "+ text. length 0); 
entryText.setText Di: 
} catch (FileNotFoundException e) { 
e.printStackTrace () ; 
} 
catch (IOException e) { 
e.printStackTrace () ; 
} 
finally{ 
if (fos '-null)( 
try { 
fos.flush () ; 
fos.close() 
) catch (IOException e) { 
e.printStackTrace () 7 


Sg Sms H H 


D 
o 


程序 运行 后 ,在 /data/data/edu. hrbeu. InternalFileDemo/files/ H 3€ F , 4R $1 T 39r at 
立 的 fileDemo. txt 文件 ,如 图 8. 5 所 示 。fileDemo. txt 从 文件 权限 上 进行 分 析 ,“-rw- 
rw- 一 "表明 文件 仅 允 许 文 件 创建 者 和 同 组 用 户 读 写 ,其 他 用 户 无 权 使 用 。 文 件 的 大 小 为 9 
个 字 节 ,保存 的 数据 为 Some data。 
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} 
n 
OnClickListener readButtonListener= new OnClicklistener() { 
@ Override 
public void onClick (View v) { 
displayView.setText ("") ; 
FileInputStream fis- null; 
try { 
fis-openFileInput (FILE. NME); 
if (fis.available()==0) { 
retum; 
} 
byte[] readBytes= new byte[fis.available()]; 
while(fis.read(readBytes) !=- DI 
) 
String text- new String (readBytes) ; 
displayiew.setText (text) ; 
labelView.setText (" 文 件 读 取 成 功 , 文 件 长 度 : "+ text. length 0); 
} catch (FileNotFoundException e) { 
e.printStackTrace () ; 
} 
catch (IOException e) { 
e.printStackTrace () ; 
} 


n 


E fe edu hrbeu InternslFileDeno 2008-07-16 02:28 drwxr-xr-x 
日 @ files 2008-07-16 02:31 drwxrwx--x 
B fileDemo. txt 9 2009-07-16 03:24 -rw-rw---- 

a lib 2009-07-16 02:28 — drwxr-xr-: x 


图 8.5 fileDemo. txt 文件 
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Android 的 外 部 存储 设备 指 的 是 SD 卡 (Secure Digital Memory Card) ,是 一 种 广泛 
使 用 于 数码 设备 上 的 记忆 卡 , 如 图 8. 6 所 示 。 虽 然 并 不 是 所 有 的 Android 手机 都 有 SD 
卡 , 但 Android 系统 提供 了 对 SD 卡 的 便捷 的 访问 方法 。 
SD 卡 适 用 于 保存 大 尺寸 的 文件 或 者 是 一 些 无 需 设置 访问 权限 的 文件 。 如 果 用 户 希 
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望 保存 录制 的 视频 文件 和 音频 文件 ,因为 设备 的 内 部 存储 空间 有 限 ,所 以 SD 卡 则 是 非常 
适合 的 选择 。 另 一 方面 ,如 果 希 望 设 置 文件 的 访问 权限 , 则 不 能 够 使 用 SD 卡 ,因为 SD 
卡 使 用 的 是 FAT(File Allocation Table) 的 文件 系统 ,不 支持 访问 模式 和 权限 控制 ,但 内 
部 存储 器 使 用 的 是 Linux 文件 系统 ,可 以 通过 文件 访问 权限 的 控制 保证 文件 的 私密 性 。 

Android 模拟 器 支持 SD F ,但 模拟 器 中 没有 默认 的 SD 卡 ,开发 人 员 必 须 在 模拟 器 中 手 
工 添 加 SD 卡 的 映像 文件 。 使 用 二 Android SDK>/tools 目录 下 的 mksdcard 工具 创建 SD 
卡 映像 文件 ,命令 如 下 : 


mksdcard - 1 SDCARD 25 E:\android\sdcard file 


第 1 个 参数 -1 表示 后 面 的 字符 串 是 SD 卡 的 标签 ,这 个 新 建立 的 SD 卡 的 标签 是 
SDCARD。 第 2 个 参数 256M 表示 SD 卡 的 容量 是 256MB。 最 后 一 个 参数 表示 SD 卡 映 
像 文件 的 保存 位 置 , 上 面 的 命令 将 映像 保存 在 E: Nandroid 目录 下 的 sdcard_file 文件 中 。 
在 CMD 中 执行 该 命令 后 , 则 可 在 所 指定 的 目录 中 找到 生产 的 SD 卡 映像 文件 。 

如 果 和 希望 Android 模拟 器 启动 时 能 够 自动 加 载 指定 的 SD 卡 ,还 需要 在 模拟 器 的 “ 运 
行 设置 "(Run Configurations) 中 添加 SD 卡 加 载 命令 。SD 卡 加 载 命 令 中 只 要 指明 映像 
文件 位 置 即 可 ,命令 如 图 8.7 所 示 。 


Samisk 77 I 
Network Speed: |Full Si 
* Lock 

Network Latency: |None || 
1 0 [ipe User Data 

e GB [Disable Boot Animation 

SD. Additional Emulator Command Line Options 
-sdcard E:\Android\sdeard_filel 


图 8.6 SDF 图 8.7 SD 卡 加 载 命令 


为 了 测试 SD 卡 映像 是 否 正确 加 载 ,在 模拟 器 启动 后 ,使 用 FileExplorer 向 SD 卡 中 
随意 上 传 一 个 文件 ,如 果 文 件 上 传 成 功 , 则 表明 SD 卡 映像 已 经 成 功 加 载 。 图 8. 8 中 向 
SD 卡 中 成 功 上 传 了 一 个 测试 文件 test. txt, 文 件 显示 在 /sdcard 目录 下 。 

ma- 


| Size! Date Time | Permiss... 
2008-06-20 00:53  drwxrwx--x 
2009-07-16 rwxrwx 


B test. txt 174 2009-07-16 14:16  ——3 
B QR system 2009-04-22 04:11 dr 


CI | 
图 8.8 SD 卡 加 载 


在 Android 系统 编程 访问 SD 卡 非 常 简单 。 首 先 需 要 检测 系统 的 /sdcard 目录 是 否 
可 用 ,如 果 不 可 用 , 则 说 明 设 备 中 的 SD 卡 已 经 被 移 除 ,在 Android 模拟 器 则 表明 SD E 
像 没 有 被 正确 加 载 。 如 果 可 用 , 则 直接 通过 使 用 标准 的 Java. io. File 类 进行 访问 。 

SDeardFileDemo 示例 说 明了 如 何 将 数据 保存 在 SD 卡 中 。 用 户 首先 通过 “生产 随机 
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数列 ”按钮 生产 10 个 随机 小 数 , 然 后 通过 * 写 人 SD 卡 ” 按 钮 将 生产 的 数据 保存 在 SD 卡 的 
目录 下 。SDcardFileDemo 示例 的 用 户 界 面 如 图 8. 9 
BUR. SDcardFileDemo 

SDeardFileDemo 示例 运行 后 ,在 每 次 单 击 “ 写 人 f erena — 
SD 卡 ” 按 钮 后 ,都 会 在 SD 卡 中 生产 一 个 新 文件 ,文件 名 | 
各 不 相同 ,如 图 8. 10 所 示 。 

SDeardFileDemo 示例 与 InternalFileDemo 示例 的 
核心 代码 比较 相似 ,不 同 之 处 在 于 代码 中 添加 了 
/sdcard 目录 存在 性 检查 (代码 第 7 行 ), 并 使 用 “绝对 目 
录 十 文件 名 ”的 形式 表示 新 建立 的 文件 (代码 第 8 行 )， 图 8.9 SDeardFileDemo 用 户 界面 
并 写 入 文件 前 对 文件 的 存在 性 和 可 写 入 性 进行 检查 ( 代 


网 昌 | 一 ” 
Name Size Date Time Permiss... 
D (E data 2008-06-20 00:53 drwxrwx--x 
SE sdcard 2008-07-16 15:17 
[B] SdcardFile-1241155731168. txt 193 2008-07-16 14:48 
B SdeardFile~1247755731369. txt 193 2009-07-16 14:48 
B SácardFile-124TT55774895. txt 187 2008-07-16 14:49 
[B] SdcardFile-124TT56083152. txt 187 2008-07-16 14:54 
B SdcardFile-124TT56146017. txt 187 2009-07-16 14:55 
[B] SdcardFile-1247T56141340. txt 187 2009-07-16 14:55 
B test. txt 174 2009-07-16 14:16 ----rw-rw- 
DL system 2009-04-22 04:11 drwxr-xr-x 
C] m H [| 


8.10 ”SD 卡 中 生产 的 文件 


码 第 12 行 )。 为 了 保证 在 SD 卡 中 多 次 写 人 时 文件 名 不 会 重复 ,在 文件 名 中 使 用 了 唯一 
且 不 重复 的 标识 (代码 第 5 行 ) ,这 个 标识 通过 调用 System. currentTimeMillis() 函数 获 
得 ,表示 从 1970 年 00:00:00 到 当前 所 经 过 的 毫秒 数 。SDcardFileDemo 示例 的 核心 代码 
uF: 


1 private static String randanNurbersString=""; 

2 OnClickListener writeButtonListener= new OnClickListener() { 

3 @ Override 

4 public void onClick (View v) { 

5 String fileName- "SdcardFile- "+ System.currentTimeMi llis ()+ ".txt"; 
6 File dir= new File ("/sdcard/") ; 

Kë if (dir.exists() && dir.canWrite()) { 

8 File newFile- new File (dir.getAbsolutePath ()+ "/"+ fileName) ; 
9 FileOutputStream fos= null; 

10 try { 

11 newFile.createNewFile () ; 

12 if (newFile.exists() && newFile.canWrite()) { 

13 fos- new FileOutputStream(newFile) ; 

14 fos.write (randanNunbersString.getBytes () ) ; 


15 TxtView labelView- (IextView) fincViesById(R. id. label) ; 
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16 labelView.setText (£ileNamet "文件 写 入 sF"); 
17 } 

18 } catch (IOException e) { 

19 e.printStackTrace () ; 

20 } finally { 

21 if (fos !=null) { 

22 try{ 

23 fos.flush(); 

24 fos.close(); 

25 } 

26 catch (IOException e) { } 
21 ) 

28 ) 

29 } 

30 } 

31 } 
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程序 开发 人 员 除 了 可 以 在 内 部 存储 设备 和 外 部 存储 设备 上 使 用 文件 以 外 ,还 可 以 将 
程序 开发 阶段 已 经 准备 好 的 原始 格式 文件 和 XML 文件 分 别 存放 在 /res/raw 和 /res/xml 
目录 下 ,供应 用 程序 在 运行 时 进行 访问 。 

原始 格式 文件 可 以 是 任何 格式 的 文件 ,例如 视频 格式 文件 .音频 格式 文件 、 图 像 文件 
和 数据 文件 等 等 ,在 应 用 程序 编译 和 打包 时 ,/res/raw 目录 下 的 所 有 文件 都 会 保留 原 有 
格式 不 变 。 而 /res/xml 目录 下 的 XML 文件 ,一 般 用 来 保存 格式 化 的 数据 ,在 应 用 程序 编 
译 和 打包 时 会 将 XML 文件 转换 为 高 效 的 二 进 制 格 式 , 应 用 程序 运行 时 会 以 特殊 的 方式 
进行 访问 。 

ResourceFileDemo 示例 演示 了 如 何在 程序 运行 时 访问 资源 文件 。 当 用 户 单 击 “ 读 取 
原始 文件 ”按钮 时 ,程序 将 读 取 /res/raw/raw_file. txt 文件 ,并 将 内 容 显示 在 界面 上 ,如 
图 8.11(a) 所 示 。 当 用 户 单 击 “ 读 取 XML 文件 ”按钮 时 ,程序 将 读 取 /res/xml/people. xml 
文件 ,并 将 内 容 显 示 在 界面 上 ,如 图 8.11(b) 所 示 。 


ab G 3:43 PM 


ResourceFileDemo 


读 取 原始 文件 读 取 XML 文 件 


(a) 读 取 原 始 文件 (b) 读 取 XML 文件 
图 8. 11  ResourceFileDemo 用 户 界面 
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读 取 原始 格式 文件 ,首先 需要 调用 getResource() 函 数 获得 资源 对 象 ,然后 通过 调用 
资源 对 象 的 openRawResource() 函 数 , 以 二 进 制 流 的 形式 打开 指定 的 原始 格式 文件 。 在 
读 取 文件 结束 后 ,调用 close O 函数 关闭 文件 流 。 

ResourceFileDemo 示例 中 关于 读 取 原始 格式 文件 的 核心 代码 如 下 : 


Resources resources- this.getResourcss () ; 
InputStream inputStream- null; 
try { 
inputStream= resources .qpenRawResouroe (R.raw.raw file); 
byte[] reader- new byte [inputStream.available()]; 
while (inputStream.read(reader) !=-1) { 
} 
displayView.setText (new String (reader, "utf- 8")) ; 
} catch (IOException e) { 
Iog.e ("ResourceFileDemo", e.getMessage(), e); 
) finally ( 
if (inputStream !- null) { 
try { 
inputStream.close () 
} 
catch (IOException e) { } 
} 
} 


o o A e D QN ro 
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代码 第 8 行 的 new String(reader."utf-8") ,表示 以 UTF-8 的 编码 方式 ,从 字 节 数组 
中 实例 化 一 个 字符 串 。 程 序 开 发 人 员 需 要 确定 /res/rawy/raw _file. txt 文件 使 用 的 是 
UTF-8 编码 方式 ,否则 程序 运行 时 会 产生 乱码 。 确 认 的 方法 是 在 raw file. txt Oc fF EA 
ili ,选择 Properties ,打开 raw. file. txt 文件 的 属性 设置 框 ,然后 在 Resource 栏 下 的 Text 
file encoding 中 ,选择 Other 为 UTF-8, 如 图 8. 12 所 示 。 


Resource 


Bath: ~ /ResourceFileDeno/res/raw/raw_file. txt 

Type: Pie (Text) 

Location: E: \Android\workplace\ResourceFileDemo\restraw\raw_file. txt 
Size: 92 bytes 

Last modified: 2009 年 T 月 17 日 下 午 10:54:54 

DBead only 

Miarchive 

Diberivea 


Text file encoding 
ODefault (inherited from container: GBK) 


@©other: [UTF-8 E 


图 8.12 更 改 raw_file. txt 文件 编码 方式 


/res/ xml 目录 下 的 XML 文件 ,与 其 他 资源 文件 有 所 不 同 ,程序 开发 人 员 不 能 够 以 流 
的 方式 直接 读 取 , 其 主要 原因 在 于 Android 系统 为 了 提高 读 取 效 率 ,减少 占用 的 存储 空 
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TR] ,将 XML 文件 转换 为 一 种 高 效 的 二 进 制 格式 。 

为 了 说 明 如 何在 程序 运行 时 读 取 /res/xml 目录 下 的 XML 文件 ,首先 在 /res/xml H 
录 下 创建 一 个 名 为 people. xml 的 文件 。XML 文件 定义 了 多 个 二 person 之 元素, 每 个 
<person> JC % thd & — Ji VE. HII name, age 和 height, 分 别 表示 姓名 年龄 和 身高 。 
/res/xml/people. xml 文件 代码 如 下 : 

1 <people> 
2 <person name= EK HE" age- "21" height= "1.81" /> 
3 < person name= "E 3i. GE" age- "25" height= "1.76" /> 
4 « person name= "E 5: HE" age- "20" height= "1.69" /> 
5 </p> 

读 取 XML 格式 文件 ,首先 通过 调用 资源 对 象 的 getXml() eR. FEAF XML 解析 器 
XmlPullParser。XmlPullParser 是 Android 平台 标准 的 XML 解析 器 ,这 项 技术 来 自 一 
个 开源 的 XML 解析 API 项 目 XMLPULL。 

ResourceFileDemo 示例 中 关于 读 取 XML 文件 的 核心 代码 如 下 : 


1 XmlPullParser parser= resources .getXml (R.xml .people) ; 

2 String msg- ""; 

3 tyf 

4 while (parser.next() !=XmlPullParser.END DOCUMENT) { 

5 String people- parser.getName () ; 

6 String name- null; 

7 String age- null; 

8 String height- null; 

9 if ((people '!=null) && people.equals ("person")) ( 

10 int count- parser.getAttributeCount () ; 

un for (int i=0; i <cant; i++) { 

12 String attrName- parser .getAttributeName (i); 

13 String attrValue= parser.getAttributeValue (i); 

14 if ((attrName !- null) && attrName.equals ("name")) ( 
15 name- attrValue; 

16 } else if ((attrName != null) && attrName.equals ("age") { 
17 age- attrValue; 

18 Jelse if((attrName !=null) && attrNare.equals ("height") ) ( 
19 height- attrValue; 

20 } 

21 } 

22 if ((name !=null) && (age !=nnll) && (height !=null)) { 

23 msg+=" 姓 名: "+ namet ", 年 龄 : "+aget ", 身 高 : "+height+ "\n"; 
24 } 

25 } 

26 } 


2] } catch (Exception e) { 
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28 Log.e ("ResourceFileDemo", e.getMessage(), e); 

29 } 

30 displayiew.setText (msg) ; 

代码 第 1 行 通过 资源 对 象 的 getXml O eh BFK HLF XML 解析 器 。 第 4 TT AY parser. 
next() 方 法 可 以 获取 到 高 等 级 的 解析 事件 ,并 通过 对 比 确定 事件 类 型 ,XML 事件 类 型 参 
考 表 8. 2。 


表 8.2 XmlPullParser 的 XML 事件 类 型 


事 件 类 型 说 明 事件 类 型 说 有 明 
START_TAG 读 取 到 标签 开始 标志 | END TAG 读 取 到 标签 结束 标志 
TEXT 读 取 文 本 内 容 END_DOCUMENT 文档 末尾 


第 5 行使 用 getrName() 函 数 获得 元 素 的 名 称 , 第 10 行使 用 getAttributeCount O PR 
数 获 取 元 素 的 属性 数量 ,第 12 行 通过 getAttributeName O 困 数 得 到 属性 名 称 。 最 后 在 
第 14 行 到 第 19 行 代码 中 ,通过 分 析 属 性 名 获取 到 正确 的 属性 值 ,并 在 第 23 行将 属性 值 
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SQLite 是 一 个 开源 的 嵌入 式 关 系数 据 库 ,2000 年 由 D. Richard Hipp 发 布 。 自 几 十 
年 前 出 现 的 商业 应 用 程序 以 来 ,数据 库 就 成 为 了 应 用 程序 的 主要 组 成 部 分 ,同时 数据 库 
管理 系统 也 变 得 非常 庞大 和 复杂 ,并 占用 了 相当 多 的 系统 资源 。 随 着 嵌入 式 应 用 程序 的 
大 量 出 现 , 一 种 新 型 的 轻 量 级 数据 库 SQLite 也 随 之 产生 。SQLite 数据 库 比 传递 的 数据 
库 更 加 适用 于 艇 和 人 式 系 统 , 因 为 它 占 用 空间 非常 少 , 运 行 高 效 可 靠 , 可 移植 性 好 ,并 且 提 
供 了 零 配 置 (zero-configuration) 运 行 模式 。 

SQLite 数据 库 的 优势 在 于 其 嵌入 到 使 用 它 的 应 用 程序 中 。 这 样 不 仅 提 高 了 运行 效 
率 , 而 且 屏蔽 了 数据 库 使 用 和 管理 的 复杂 性 ,程序 仅 需要 进行 最 基本 的 数据 操作 ,其 他 操 
作 可 以 交 给 进程 内 部 的 数据 库 引 擎 完成。 同时 因为 客户 端 和 服务 器 在 同一 进程 空间 运 
行 ,不 需要 进行 网 络 配置 和 管理 ,因此 减少 了 网 络 调用 所 造成 的 额外 开销 ,简化 的 数据 库 
的 管理 过 程 ,使 应 用 程序 更 加 易于 部 署 和 使 用 。 程 序 开 发 人 员 仅 需要 把 SQLite 数据 库 
正确 编译 到 应 用 程序 中 即 可 。 

SQLite 数据 库 采 用 了 模块 化 设计 ,模块 将 复杂 的 查询 过 程 分 解 为 细小 的 工作 进行 处 
理 。SQLite 数据 库 由 8 个 独立 的 模块 构成 ,这 些 独立 模块 又 构成 了 三 个 主要 的 子 系统 。 
SQLite 数据 库 体系 结构 如 图 8. 13 所 示 。 

接口 由 SQLite C API 组 成 ,因此 无 论 是 应 用 程序 、 和 脚本 ,还 是 库 文件 ,最 终 都 是 通过 
接口 与 SQLite 交互 。 
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操作 系统 接口 


—— 
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8.13 SQLite 数据库 体系 结构 


在 编译 器 中 ,分 词 器 和 分 析 器 对 SQL 语句 进行 语法 检查 ,然后 把 SQL 语句 转化 为 底 
层 能 更 方便 处 理 的 分 层 的 数据 结构 ,这 种 分 层 的 数据 结构 称 为 “语法 树 ”。 然 后 把 语法 树 
传 给 代码 生成 器 进行 处 理 , 生 成 一 种 针对 SQLite 的 汇编 代码 ,最 后 由 虚拟 机 执行 。 

SQLite 数据 库 体 系 结构 中 最 核心 的 部 分 是 虚拟 机 ,也 称 为 虚拟 数据 库 引 擎 (Virtual 
Database Engine,VDBE)。 与 Java 虚拟 机 相似 ,虚拟 数据 库 引 擎 用 来 解释 执行 字 节 代 
码 。 虚 拟 数据 库 引 擎 的 字 节 代码 由 128 个 操作 码 构 成 ,这 些 操 作 码 主要 用 以 对 数据 库 进 
行 操作 ,每 一 条 指令 都 可 以 完成 特定 的 数据 库 操 作 ,或 以 特定 的 方式 处 理 栈 的 内 容 。 

后 端 由 B- 树 、 页 缓存 和 操作 系统 接口 构成 。B- 树 和 页 缓存 共同 对 数据 进行 管理 。 
B- 树 的 主要 功能 就 是 索引 , 它 维护 着 各 个 页 面 之 间 的 复杂 的 关系 ,便于 快速 找到 所 需 数 
据 。 页 缓存 的 主要 作用 就 是 通过 操作 系统 接口 在 B- 树 和 磁盘 之 间 传 递 页 面 。 

SQLite 数据 库 具 有 很 强 的 移植 性 ,可 以 运行 在 Windows. Linux, BSD, Mac OS X 和 
一 些 商用 UNIX 系统 ,比如 Sun 公司 的 Solaris. IBM 公司 的 AIX。 同 样 ,也 可 以 工作 在 
UES HR A at PRE A BEF. Di QNX. VxWorks, Palm OS, Symbin 和 Windows CE, 
SQLite 的 核心 大 约 有 3 万 行 标准 C 代码 ,模块 化 的 设计 使 这 些 代码 更 加 易于 理解 。 
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在 Android 系统 中 ,每 个 应 用 程序 的 SQLite 数据 库 被 保存 在 各 自 的 /data/data/ 
<package name>/databases 目录 下 。 上 默认 情况 下 ,所 有 数据 库 都 是 私有 的 , 仅 允 许 创 建 
数据 库 的 应 用 程序 访问 ,如 果 需 要 共享 数据 库 则 可 以 使 用 ContentProvider。 虽 然 应 用 程 
序 完全 可 以 在 代码 中 动态 建立 SQLite 数据 库 , 但 通过 命令 行 手 工 建立 和 管理 数据 库 仍 
然 是 非常 重要 的 内 容 , 对 于 调试 具有 数据 库 的 应 用 程序 非常 有 用 。 

手动 建立 数据 库 指 的 是 使 用 sqlite3 工具 ,通过 手工 输入 命令 行 完成 数据 库 的 建立 过 
程 。sqlite3 是 SQLite 数据 库 自 带 的 一 个 基于 命令 行 的 SQL 命令 执行 工具 ,并 可 以 显示 
命令 执行 结果 。sqlite3 工具 被 集成 在 Android 系统 中 ,用 户 在 Linux 的 命令 行 界面 中 输 
入 sqlite3 可 启动 sqlite3 工具 ,并 得 到 工具 的 版 本 信息 ,如 下 面 的 代码 所 示 。 启 动 Linux 
的 命令 行 界面 的 方法 是 在 CMD 中 输入 adb shell 命令 。 
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#sqlite3 
SQLite version 3.5.9 
Enter ".help" for instructions 
sqlite> 

在 启动 sqlite3 工具 后 ER EA * = FEW“ sqlite>”. em tit 11 FE A 5j SQLite 
数据 库 的 交互 模式 ,此 时 可 以 输入 命令 建立 .删除 或 修改 数据 库 的 内 容 。 正确 退 出 
sqlite3 工具 的 方法 是 使 用 . exit 命令 。 
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2 + 

原则 上 ,每 个 应 用 程序 的 数据 库 都 保存 在 各 自 的 /data/data/ 二 package name >/ 
databases 目录 下 ,但 如 果 使 用 手工 方式 建立 数据 库 , 则 必须 手工 建立 数据 库 目 录 , 目 前 版 
本 无 须 修改 数据 库 目 录 的 权限 。 


ih 3 mkdir databases 

2 #is-1 

3 drwxrwxrwx root root 2009- 07- 18 15:43 databases 
4 drwxr- xr- x system system 2009- 07- 18 15:31 lib 

5 + 


在 SQLite 数据 库 中 ,每 个 数据 库 保 存在 一 个 独立 的 文件 中 ,使 用 sqlite3 工具 后 加 文 
件 名 的 方式 打开 数据 库 文件 ,如 果 指 定 的 文件 不 存在 ,sqlite3 工具 则 自动 创建 新 文件 。 
下 面 的 代码 将 创建 名 为 people 的 数据 库 ,在 文件 系统 中 将 产生 一 个 名 为 people. db 的 数 
据 库 文件 。 


# sqlite3 people.do 
SQLite version 3.5.9 
Enter ".help" for instructions 
sqlite 

下 面 的 代码 在 新 创建 的 数据 库 中 ,构造 了 一 个 名 为 peopleinfo 的 表 , 使 用 create 
table 命令 ,关系 模式 为 peopleinfo (id. name. age，height) 。 表 包含 4 个 属性 ，id 是 
整 型 的 主键 ;name 表示 姓名 ,字符 型 ;not null 表示 这 个 属性 一 定 要 填写 ,不 可 以 为 空 值 ; 
age 表示 年 龄 ,整数 型 ;height 表示 身高 , 浮 点 型 。 
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sqlite> create table peopleinfo 
-..? ( id integer primary key autoincrement, 
-..» name text not null, 
.> age integer, 
-..» height float); 
sqlite> 
为 了 确认 数据 表 是 否 创 建成 功 ,可 以 使 用 . tables 命令 ,显示 当前 数据 库 中 的 所 有 表 。 
从 下 面 的 代码 中 可 以 观察 到 ,当前 数据 库 仅 有 一 个 名 为 peopleinfo 的 表 。 
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sqlite> .tables 
poepleinfo 
sqlite> 


当然 ,也 可 以 使 用 . schema 命令 查看 建立 表 时 使 用 的 SQL 命令 。 如 果 当 前 数据 库 中 
包含 多 个 表 , 则 可 以 使 用 [. schema 表 名 j] 的 形式 ,显示 指定 表 的 建立 命令 。 
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sqlite .schema 

CREATE TABLE peopleinfo ( id integer primary key autoincrement, 
name text not null, age integer, height float); 

sqlite> 


下 一 步 是 向 peopleinfo 表 中 添加 数据 ,使 用 insert into... values 命令 。 在 下 面 的 
代码 运行 成 功 后 ,数据 库 的 peopleinfo 表 将 有 三 条 数据 ,内 容 如 表 8. 3 所 示 。 因 为 _id 是 
自 增 加 的 主键 ,因此 在 输入 null 后 ,SQLite 数据 库 会 自动 填写 该 项 的 内 容 。 


1 
2 
3 


sqlite> insert into peopleinfo values (null, "Tam',21,1.81) ; 
sqlite insert into peopleinfo values (null, 'Jim',22,1.78) ; 
sqlite> insert into peopleinfo values (null, 'Lily',19,1.68); 


# 8.3  peopleinfo RAF 


_id name age height 
1 Tom 21 1.81 
2 Jim 22 1,78 
3 Lily 19 1.68 


在 数据 添加 完毕 后 ,使 用 select 命令 ,显示 指定 数据 表 中 的 所 有 数据 信息 ,命令 格式 
为 Lselect 属性 from 表 名 ]。 下 面 的 代码 用 来 显示 peopleinfo 表 的 所 有 数据 。 
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select * fran peopleinfo; 
1| Tam] 2111.81 

2| Jiml 2211.78 

3|Lilyl 19] 1.68 

sqlite> 


上 面 的 查询 结果 看 起 来 不 是 非常 直观 ,可 以 使 用 mode 命令 将 结果 输出 格式 更 改 为 
“表格 ”方式 。mode 命令 除了 支持 常见 的 column 格式 ,还 支持 csv 格式 、html 格式 、 
insert 格式 ,line 格式 list 格式 、tabs 格式 和 tel 格式 。 
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sqlite> .mode colum 
sqlite> select * from peopleinfo; 


1 Tom 21 1.81 
2 Jim 2 1.78 
3 Lily 19 1.68 


更 新 数据 可 以 使 用 update 命令 ,命令 格式 为 update KA set 属性 二 "新 值 " where 
条 件 ]。 更 新 数据 后 ,同样 使 用 select 命令 显示 数据 , 则 可 以 确定 数据 是 否 正确 更 新 。 下 
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面 的 代码 将 姓名 为 Lily 数据 中 的 高 度 值 更 新 为 1. 88。 
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删除 数据 可 以 使 用 delete 命令 ,命令 格式 为 [delete from KA where 条 件 ]。 下 面 的 


sqlite> update peopleinfo set height= 1.88 where name= "Lily"; 
sqlite> select * from peopleinfo; 


select * fram peopleinfo; 


1 Tom 21 1.81 
2 Jim 2 1.78 
3 Lily 19 1.88 
sqlite> 


代码 将 _id 为 3 的 数据 从 表 peopleinfo 中 删除 。 


1 sqlite>delete fram pecpleinfo where _id= 3; 
2 sqlite> select * from peopleinfo; 
3 select * from peopleinfo; 
4 1 Tan 21 1.81 
5 2 Jim 22 1.78 
6 sqlite 
sqlite3 工具 还 支持 大 量 的 命令 ,可 以 使 用 . help 命令 查询 sqlite3 的 命令 列表 ,也 可 以 
参考 表 8. 4。 
表 8.4 sqlite3 命令 列表 
编 号 命 S 说 OB 
1 .bail ON| OFF 遇 到 错误 时 停止 ,默认 为 OFF 
2 . databases 显示 数据 库 名 称 和 文件 位 置 
3 .dump ? TABLE? ... 将 数据 库 以 SQL 文本 形式 导出 
4 . echo ON| OFF 开启 和 关闭 回 显 
5 . exit 退出 
6 .explain ON| OFF BD E IET UNUS 
7 . header(s) ON| OFF 开启 或 关闭 标题 显示 
8 . help 显示 帮助 信息 
9 .import FILE TABLE 将 数据 从 文件 导入 表 中 
10 .indices TABLE 显示 表 中 所 的 列 名 
11 .load FILE ? ENTRY? 导入 扩展 库 
12 .mode MODE ? TABLE? 设置 输入 格式 
13 .nullvalue STRING 打印 时 使 用 STRING 代替 NULL 
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续 表 
A 号 命 S 说 OA 
14 .output FILENAME 将 输入 保存 到 文件 
15 .output stdout 将 输入 显示 在 屏幕 上 
16 . prompt MAIN CONTINUE 替换 标准 提示 符 
17 . quit 退出 
18 . read FILENAME 在 文件 中 执行 SQL 语句 
19 . schema ? TABLE? 显示 表 的 创建 语句 
20 . separator STRING 更 改 输入 和 导入 的 分 隔 符 
21 . show 显示 当前 设置 变量 值 
22 .tables ? PATTERN? 显示 符合 匹配 模式 的 表 名 
23 .timeout MS 尝试 打开 被 锁定 的 表 MS 毫秒 
24 . timer ON| OFF 开启 或 关闭 CPU 计时 器 
25 . width NUM NUM… 设置 column 模式 的 宽度 
833 代码 建 库 


在 代码 中 动态 建立 数据 库 是 比较 常用 的 方法 。 例 如 在 程序 运行 过 程 中 , 当 需 要 进行 
数据 库 操作 时 ,应 用 程序 会 首先 尝试 打开 数据 库 , 此 时 如 果 数 据 库 并 不 存在 ,程序 则 会 自 
动 建 立 数 据 库 , 然 后 再 打开 数据 库 。 

在 编程 实现 时 ,一 般 将 所 有 对 数据 库 的 操作 都 封装 在 一 个 类 中 ,因此 只 要 调用 这 个 
类 ,就 可 以 完成 对 数据 库 的 添加 ,更 新 .删除 和 查询 等 操作 。 下 面 内 容 是 DBAdapter 类 的 
部 分 代码 ,封装 了 数据 库 的 建立 .打开 和 关闭 等 操作 : 


1 
2 
3 
4 
5 
6 
p 
8 
9. 


public class DBAdapter { 
private static final String DB NAME- "people.db"; 
private static final String DB TABIE- "peopleinfo"; 
private static final int DB VERSION- 1; 


public static final String KEY ID-" id"; 
public static final String KEY NAME- "name"; 
public static final String KEY AGE- "age"; 
public static final String KEY HEIGHP- "height"; 


private SQLiteDatabase db; 


private final Context context; 
private DBOpenHelper doQpenHelper; 


private static class DBOpenHelper extends SQLiteOpenHelper {} 
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17 public DBAdapter (Context context) { 

18 context- context; 

19 H 

20 

21 public void open() throws SQLiteException { 

2 dbopenHelper= new DBQpenHelper (context, DB NAME, null, DB VERSION); 
23 try { 

24 do- dbopenHelper.getWritableDatabase(); 
25 Jcatch (SQLiteFxception ex) { 

26 do- diOpenHelper .getReadableDatabase () ; 
27 } 

28 } 

29 

30 public void close () { 

31 if (db !=null){ 

32 do.close(); 

33 do- null; 

34 } 

35 } 

36 ] 


从 代码 的 第 2 行 到 第 9 行 可 以 看 出 ,在 DBAdapter 类 中 首先 声明 了 数据 库 的 基本 信息 ， 
包括 数据 库 文件 的 名 称 .数据 库 表 格 名 称 和 数据 库 版 本 ,以 及 数据 库 表 中 的 属性 名 称 。 从 
这 些 基 本 信息 上 不 难 发 现 ,这 个 数据 库 与 8. 3. 2 节 手 动 建立 的 数据 库 是 完全 相同 的 。 

代码 第 11 行 声 明了 SQLiteDatabase 对 象 db。SQLiteDatabase 类 封装 了 非常 多 的 
方法 ,用 以 建立 、 删 除数 据 库 ,执行 SQL 命令 ,对 数据 进行 管理 等 工作 。 

代码 第 13 行 声明 了 一 个 非常 重要 的 帮助 类 SQLiteOpenHelper, 这 个 帮助 类 可 以 辅 
助 建立 、 更 新 和 打开 数据 库 。 虽 然 在 代码 第 21 行 定义 了 open() 函数 用 来 打开 数据 库 , 但 
open() 函 数 中 并 没有 任何 对 数据 库 进行 实际 操作 的 代码 ,而 是 调用 了 
SQLiteOpenHelper 类 的 getWritableDatabase() RA getReadableDatabase() MM, 3X 
个 两 个 函数 会 根据 数据 库 是 否 存在 .版 本 号 和 是 否 可 写 等 情况 ,决定 在 返回 数据 库 对 象 
前 ,是 否 需 要 建立 数据 库 。 

在 代码 第 30 行 的 closeO MRCP WH T SQLiteDatabase 对 象 的 close() 方 法 关闭 数 
据 库 。 这 是 上 面 的 代码 中 ,唯一 的 一 个 地 方 直接 调用 了 SQLiteDatabase 对 象 的 方法 。 
SQLiteDatabase 中 也 封装 了 打开 数据 库 的 函数 openDatabases() 和 创建 数据 库 函 数 
openOrCreateDatabases() ,因为 代码 中 使 用 了 帮助 类 SQLiteOpenHelper, 从 而 避免 直接 
调用 SQLiteDatabase 中 的 打开 和 创建 数据 库 的 方法 ,简化 了 数据 库 打 开 过 程 中 繁琐 的 逻 
辑 判断 过 程 。 

代码 第 15 行 实现 了 内 部 静态 类 DBOpenHelper, 继 承 了 帮助 类 SQLiteOpenHelper， 
重 载 7 onCreateO PR MA onUpgrade() AM. (ti MN F: 


172 人 aaaix 


private static class DBQpenHelper extends SoLiteopenHelper { 
public DBOpenHelper (Context context, String name, CursorFactory factory, int version) { 
super (context, name, factory, version) ; 
} 
private static final String DB CREATE- "create table "+ 
TB TABIE+" ("+KEY_ID+" integer primary key autoincrement, "+ 
KEY NAME+ " text not null, "+KEY AGEt" integer, "+ KEY HEIGHT+ " float) ;"; 


o c A o Dm e oh ro 


@ Override 

public void onCreate (SQliteDatabase db) { 
. do.execSQOL(DB CREATE); 
} 


Bà 
o 


@ Override 
public void onUpgrade (SQLiteDatabase_dbo, int oldVersion, int_ 
newVersion) ( 

. db.execSQL ("DROP TABLE IF EXISTS "+ DB. TABLE); 

onCreate (_db); 
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} 


代码 的 第 5 行 到 第 7 行 是 创建 表 的 SQL 命令 。 代 码 第 10 行 和 第 15 行 分 别 重 载 了 
onCreate() ER BC HI onUpgradeO Ph RC 3x FEAK IK SQLiteOpenHelper 类 必须 重 载 的 两 个 函数 。 
onCreate O 函数 在 数据 库 第 一 次 建立 时 被 调用 ,一 般 用 来 创建 数据 库 中 的 表 , 并 做 适当 的 初 
始 化 工作 。 在 代码 第 11 行 中 ,通过 调用 SQLiteDatabase 对 象 的 execSQL() 方 法 ,执行 创建 
表 的 SQL 命令 。onUpgrade() 函数 在 数据 库 需 要 升级 时 被 调用 ,一 般 用 来 删除 旧 的 数据 库 
表 , 并 将 数据 转移 到 新 版 本 的 数据 库 表 中 。 在 代码 第 16 行 和 第 17 行 中 ,为 了 简单 起 见 ,并 
没有 做 任何 数据 转移 ,而 仅仅 删除 原 有 的 表 后 建立 新 的 数据 库 表 。 

程序 开发 人 员 不 应 直接 调用 onCreate () 和 onUpgrade ( ) 函数 ,而 应 该 由 
SQLiteOpenHelper 类 来 决定 何 时 调用 这 两 个 函数 。SQLiteOpenHelper 类 的 
getWritableDatabase( ) 函数 和 getReadableDatabase C) 图 数 是 可 以 直接 调用 的 函数 。 
get WritableDatabase() 函数 用 来 建立 或 打开 可 读 写 的 数据 库 对 象 ,一旦 函数 调用 成 功 ， 
数据 库 对 象 将 被 缓存 ,任何 需要 使 用 数据 库 对 象 时 ,都 可 以 调用 这 个 方法 获取 到 数据 库 
对 象 ,但 一 定 要 在 不 使 用 时 调用 close() 郴 数 关闭 数据 库 。 如 果 保 存 数据 库 文件 的 磁盘 空 
间 已 满 ,调用 getWritableDatabase() 函 数 则 无 法 获得 可 读 写 的 数据 库 对 象 ,这 时 可 以 调 
用 getReadableDatabase() 限 数 , 获 得 一 个 只 读 的 数据 库 对 象 。 

当然 ,如果 程序 开发 人 员 不 希望 使 用 SQLiteOpenHelper 类 ,同样 可 以 直接 创建 数据 
库 。 首 先 调用 openOrCreateDatabases() 函 数 创建 数据 库 对 象 , 然 后 执行 SQL 命令 建立 
数据 库 中 的 表 和 直接 的 关系 ,示例 代码 如 下 : 


1 private static final String DB CREATE- "create table "+ 
2 DB TABLEt" ("+ KEY IDt" integer primary key autoincrement, "+ 
3 KEY NAME+ " text not null, "+ KEY AGE+ " integer,"+ KEY HEIGHT+" float);"; 
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public void create() { 
db.qpenOrCreateDatabases (DB NAME, context .MODE PRIVATE, null) 
do.execSQL(DB CREATE); 
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834 数据 操作 


数据 操作 指 的 是 对 数据 的 添加 、 删 除 .查找 和 更 新 的 操作 ,虽然 程序 开发 人 员 完 全 可 
以 通过 执行 SQL 命名 完成 数据 操作 ,但 还 是 推荐 使 用 Android 提供 的 专用 类 和 方法 ,这 
些 类 和 方法 更 加 简洁 、 易 用 。 

为 了 使 DBAdapter 类 支持 对 数据 的 添加 、 删 除 、 更 新 和 查找 等 功能 ,在 DBAdapter 
类 中 增加 下 面 的 这 些 函 数 。 其 中 , insert (People people) 用 来 添加 一 条 数据 ， 
queryAllData O 用 来 获取 全 部 数据 , queryOneData (long id) 根 据 id 获取 一 条 数据 ， 
deleteAllData( ) 用 来 删除 全 部 数据 , deleteOneData (long id) 根据 id 删除 一 条 数据 ， 
updateOneData(long id ，People people) fi Jg id 更 新 一 条 数据 。 


1 public class DBAdapter { 
2 public long insert (People people) {} 

3 public long deleteAllData() { } 

4 public long deleteOneData (long id) { } 

5 public People[] queryAllData() {} 

6 public People[] queryOneData (long id) { } 

了 public long updateOneData (long id , People Pecple){ } 
8 

9 


private People[] ConvertToPeople (Cursor cursor) {} 
10 } 


ConvertToPeople(Cursor cursor) 是 私有 函数 ,作用 是 将 查询 结果 转换 为 用 来 存储 数 
据 自 定义 的 People RXR. People 类 的 包含 4 个 公共 属性 ,分 别 为 ID、Name、Age 和 
Height, 对 应 数据 库 中 的 4 个 属性 值 。 重 载 toString() 函 数 ,主要 是 便于 界面 显示 的 需 
H, People 类 的 代码 如 下 : 


public class People { 
public int ID=- 1; 
public String Name; 
public int Age; 
public float Height; 


@ Override 

public String toString() { 
String result- ""; 
resultt- "ID; "+ this.ID+ ", "; 
result — "IE ; "+ this.Namet ", "; 
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2 resultt- "ERE; "+this.Aget", "; 
13 result+ =" Ej. "+ this.Height+ ", "; 
14 retum result; 

15 ) 

16 ) 


SQLiteDatabase 类 的 公共 函数 insert „delete 3. update O All query O ,封装 了 执行 
的 添加 、 删 除 、 更 新 和 查询 功能 的 SQL 命令 。 下 面 分 别 介 绍 如 何 使 用 SQLiteDatabase 类 
的 公共 函数 ,完成 数据 的 添加 、 删 除 .更 新 和 查询 等 操作 。 


1. 添加 功能 


为 了 添加 一 条 新 数据 ,首先 构造 一 个 ContentValues 对 象 ,然后 调用 ContentValues 
对 象 的 put () 方 法 ,将 每 个 属性 的 值 写 入 到 ContentValues 对 象 中 ,最 后 使 用 
SQLiteDatabase 对 象 的 insert O ER EI ,将 ContentValues 对 象 中 的 数据 写 人 指定 的 数据 
库 表 中 。insert() 函 数 的 返回 值 是 新 数据 插入 的 位 置 , 即 ID 值 。ContentValues 类 是 一 
个 数据 承载 容器 ,主要 用 来 向 数据 库 表 中 添加 一 条 数据 。 


public long insert (People people) { 
ContentValues new/alues- new ContentValues () ; 


1 

2 

3 

4 newValues.put(KEY NAME, people.Name) ; 

5 newalues.put(KEY ACE, people.Age); 

6 new/alues.put(KEY HEIGHT, people.Height) ; 
7 

8 

9 


return db. insert (DB TABIE, null, newValues); 
) 
第 4 行 代 码 向 ContentValues Xf Z& newValues "P 3 JIII— P 44 HK {AX put FR CR 
第 1 个 参数 是 名 称 , 第 2 个 参数 是 值 。 在 第 8 行 代码 的 insert() 函 数 中 ,第 1 个 参数 是 数 
据 表 的 名 称 ,第 2 个 参数 是 在 NULL 时 的 替换 数据 ,第 3 个 参数 是 需要 向 数据 库 表 中 添 
加 的 数据 。 


2. 删除 功能 


删除 数据 比较 简单 ,只 需要 调用 当前 数据 库 对 象 的 delete() 函 数 ,并 指明 表 名 称 和 删 
除 条 件 即 可 。 


public long deleteAllData() { 
return db.delete (DB TABIE, null, null); 
) 


public long deleteOneData (long id) { 
return do.delete(DB TABIE, KEY ID+'"="+ id, null); 
) 
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delete() 函 数 的 第 1 个 参数 是 数据 库 的 表 名 称 , 第 2 个 参数 是 删除 条 件 。 在 第 2 行 代 
码 中 ,删除 条 件 为 null, 表 示 删 除 表 中 的 所 有 数据 。 而 代码 第 6 行 则 指明 了 需要 删除 数据 
的 id 值 ,因此 deleteOneData() 函 数 仅 删 除 一 条 数据 ,此 时 delete() 函 数 的 返回 值 表 示 被 
删除 的 数据 的 数量 。 


3. 更 新 功能 


更 新 数据 同样 要 使 用 ContentValues 对 象 ,首先 构造 ContentValues 对 象 ,然后 调用 
put O 函数 将 属性 的 值 写 人 到 ContentValues 对 象 中 ,最 后 使 用 SQLiteDatabase 对 象 的 
update() 函 数 , 并 指定 数据 的 更 新 条 件 。 


1 public long updateOneData (long id , People people) { 

2 ContentValues updateValues- new ContentValues () ; 
3 updateValues.put(KEY NAME, people.Name); 

4 updateValues .put (KEY ACE, people.Age) ; 

5 updateValues.put(KEY HEIGHT, people.Height) ; 

6 

" 

8 


return db.update (DB TABLE, updateValues, KEY ID "- "tid, null); 
} 
在 代码 的 第 7 行 中 ,update() 函 数 的 第 1 个 参数 表示 数据 表 的 名 称 , 第 2 个 参数 是 更 
新 条 件 。update() 函 数 的 返回 值 表示 数据 库 表 中 被 更 新 的 数据 数量 。 
4. 查询 功能 


介绍 查询 功能 前 , 先 要 介绍 Cursor 类 。 在 Android 系统 中 ,数据 库 查询 结果 的 返回 
值 并 不 是 数据 集合 的 完整 拷贝 ,而 是 返回 数据 集 的 指针 ,这 个 指针 就 是 Cursor 类 。 
Cursor 类 支持 在 查询 的 数据 集合 中 多 种 移动 方式 ,并 能 够 获取 数据 集合 的 属性 名 称 和 序 
号 ,具体 的 方法 和 说 明 可 以 参考 表 8. 5。 


表 8.5 Cursor 类 的 方法 和 说 明 


Ed 数 说 RB 
moveToFirst 将 指针 移动 到 第 一 条 数据 上 
moveToNext 将 指针 移动 到 下 一 条 数据 上 
moveToPrevious 将 指针 移动 到 上 一 条 数据 上 
getCount 获取 集合 的 数据 数量 
getColumnIndexOrThrow 返回 指定 属性 名 称 的 序号 ,如果 属 性 不 存在 则 产生 异常 
getColumnName 返回 指定 序号 的 属性 名 称 
getColumnNames 返回 属性 名 称 的 字符 串 数 组 
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BR 
i E 说 明 
getColumnIndex 根据 属性 名 称 返 回 序号 
moveToPosition 将 指针 移动 到 指定 的 数据 上 
getPosition 返回 当前 指针 的 位 置 


从 Cursor 中 提取 数据 可 以 参考 ConvertToPeople () eh AW S: 307; ik. fk HE 
Cursor 数据 中 的 数据 前 ,推荐 测试 Cursor 中 的 数据 数量 ,避免 在 数据 获取 中 产生 异常 ， 
例如 代码 的 第 3 行 到 第 5 行 。 从 Cursor 中 提取 数据 使 用 安全 类 型 的 get — Type O PR 
数 ,函数 的 输入 值 为 属性 的 序号 ,为 了 获取 属性 的 序号 ,可 以 使 用 getColumnIndex() 函 数 


获取 指定 属性 的 序号 。 
1 private People[] ConvertToPeople (Cursor cursor) ( 
2 int resultCounts- cursor.getCount () ; 
3 if (resultCounts==0 || !cursor.moveToFirst ()) { 
4 return null; 
5 } 
6 People[] peoples- new People [resultCounts] ; 
Ei for (int i- 0 ; i< resultCounts; i++){ 
8 peoples[i]- new People () ; 
9 peoples [i] . ID= cursor.getInt (0) ; 
10 peoples [i] .Name- cursor.getString (cursor .getColumIndex (KEY NAME)); 
1 peoples [i] .Age- cursor.get Int (cursor.getColumnIndex(KEY ACE)); 
2 peoples [i] .Height- cursor.getFloat (cursor.getColumnIndex (KEY HEIGHT) ) ; 
13 cursor. .moveToNext () 7 
14 } 
15 return peoples; 
16 } 


要 进行 数据 查询 就 需要 调用 SQLiteDatabase KAY query() 函 数 , 这 个 函数 的 参数 较 
多 ,可 以 参考 表 8.6 参数 说 明 ,query() 函 数 的 语法 如 下 : 


Cursor android.database.sqlite.SQLiteDatabase.query (String table, String[] colums, String selection, 
String[] selectionArgs, String groupBy, String having, String orderBy) 


表 8.6 query() 函 数 的 参数 说 明 


位 置 类 型 十 名 称 说 AA 
1 String table RAK 
2 String[ ] columns 返回 的 属性 列 名 称 
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续 表 
位 置 类 型 十 名 称 说 明 
3 String selection 查询 条 件 
4 String[ ] selectionArgs 如 果 在 查询 条 件 中 使 用 问号 , 则 需要 定义 蔡 换 符 的 具体 内 容 
5 String groupBy 分 组 方式 
6 String having 定义 组 的 过 滤器 
7 String orderBy 排序 方式 
下 面 给 出 根据 id 查询 数据 的 代码 : 
1 public People[] getOneData (long id) { 
2 Cursor results-db.query(DB TABLE, new String[] ( KEY ID, KEY NAME, KEY AGE, KEY HEIGHT), 
KEY ID "— "t id, null, null, null, null); 
3 return ConvertToPeople (results) ; 
4 } 
下 面 是 查询 全 部 数据 的 代码 : 
1 public Pecple[] getAllpata() { 
2 Cursor results- db.query (DB TABLE, new String[] ( KEY ID, KEY NAME, KEY AGE, KEY HEIGHT}, 
null, null, null, null, null); 
3 return ConvertToPeople (results); 


4 } 


SQLiteDemo 是 对 数据 库 操 作 的 一 个 示例 , 如 
图 8. 14 所 示 。 在 这 个 示例 中 ,用 户 可 以 在 界面 的 上 方 输 
入 数据 信息 ,通过 “添加 数据 "按钮 将 数据 写 人 数据 库 。 
“全 部 显示 ”相当 于 查询 数据 库 中 的 所 有 数据 ,并 将 数据 
显示 在 界面 下 方 。“ 清 除 显示 ” 仅 是 清除 界面 下 面 显示 
的 数据 ,而 不 对 数据 库 进行 任何 操作 . “全 部 删除 "是 数 = 
据 库 操作 ,将 删除 数据 库 中 的 所 有 数据 。 在 界面 中 部 ， 国 [om foss 
以 “ID 十 功能 ”命名 的 按钮 ,分 别 是 根据 ID 删除 数据 , 根 6 
JE ID 进行 数据 查询 ,根据 ID 更 新 数据 ,而 这 个 ID 值 就 取 
自 本 行 的 EditText 控件 。 下 面 不 再 给 出 SQLiteDemo 示 
例 的 代码 。 图 8.14 SQLiteDemo 用 户 界面 
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ContentProvider( 数 据 提 供 者 ) 是 在 应 用 程序 间 共 享 数据 的 一 种 接口 机 制 。 应 用 程 
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序 在 不 同 的 进程 中 运行 ,因此 ,数据 和 文件 在 不 同 应 用 程序 之 间 是 不 能 够 直接 访问 的 。 
SharedPreferences 和 文件 存储 为 跨越 程序 边界 的 访问 提供 了 方法 ,但 这 些 方法 都 有 局 限 
TE. ContentProvider 提供 了 更 为 高 级 的 数据 共享 方法 ,应 用 程序 可 以 指定 需要 共享 的 数 
据 ,而 其 他 应 用 程序 则 可 以 在 不 知 数据 来 源 、 路 径 的 情况 下 ,对 共享 数据 进行 查询 、 添 加 、 
删除 和 更 新 等 操作 。 

Android 系统 中 ,除了 程序 开发 人 员 通 过 ContentProvider 提供 的 共享 数据 外 ,还 有 
许多 Android 系统 的 内 置 数 据 也 通过 ContentProvider 提供 给 用 户 使 用 ,例如 通讯 录 、 音 
视频 文件 和 图 像 文件 等 等 。 

在 创建 ContentProvider 时 ,需要 首先 使 用 数据 库 .文件 系统 或 网 络 实现 底层 存储 功 
能 ,然后 在 继承 ContentProvider 的 类 中 实现 基本 数据 操作 的 接口 函数 ,包括 添加 、 删 除 、 
查找 和 更 新 等 功能 。 调 用 者 不 能 够 直接 调用 ContentProvider 的 接口 函数 ,而 需要 使 用 
ContentResolver 对 象 ,通过 URI 间接 调用 ContentProvider, 调 用 关系 如 图 8. 15 所 示 。 


| ContentResolver | ContentProvide } 


| 文人 系统 ] [mme | ( mm | 


8.15 ContentProvider 调用 关系 


程序 开发 人 员 使 用 ContentResolver 对 象 5j ContentProvider 进行 交互 ,而 
ContentResolver 则 通过 URI 确定 需要 访问 的 ContentProvider 的 数据 集 。 在 发 起 一 个 
请 求 的 过 程 中 ,Android 首先 根据 URI 确定 处 理 这 个 查询 的 ContentResolver, 然 后 初始 
化 ContentResolver 所 有 需要 的 资源 ,这 个 初始 化 的 工作 是 Android 系统 完成 的 ,无 需 程 
序 开 发 人 员 参 与 。 一 般 情 况 下 只 有 一 个 ContentResolver 对 象 ,但 却 可 以 同时 与 多 个 
ContentResolver 进行 交互 。 

ContentProvider 完全 屏蔽 了 数据 提供 组 件 的 数据 存储 方法 。 在 使 用 者 看 来 ,数据 提 
供 者 通过 ContentProvider 提供 了 一 组 标准 的 数据 操作 接口 , 却 无 法 得 知 数据 提供 者 的 
数据 存储 方 。 数 据 提供 者 可 以 使 用 SQLite 数据 库存 储 数据 ,也 可 以 通过 文件 系统 或 
SharedPreferences 存储 数据 ,甚至 是 使 用 网 络 存储 的 方法 ,这 些 内 容 对 数据 使 用 者 都 是 
不 可 见 的 。 同 时 也 正 是 因为 屏蔽 数据 的 存储 方法 ,很 大 程度 上 简化 了 ContentProvider 
的 使 用 难度 ,使 用 者 只 要 调用 Content Provider 提供 的 接口 函数 ,就 可 完成 所 有 的 数据 操 
TE ,而 具体 的 数据 存储 方法 则 是 ContentProvider 的 设计 者 应 去 思考 的 问题 。 

ContentProvider 的 数据 模式 似 于 数据 库 的 数据 表 , 每 行 是 一 条 记录 ,每 列 具 有 相同 
的 数据 类 型 ,如 表 8.7 所 示 。 每 条 记录 都 包含 一 个 长 型 的 字段 _ID ,用 来 唯一 标识 每 条 记 


表 8.7  ContentProvider 数据 模型 


_ID NAME AGE HEIGHT 


1 Tom 21 1.81 


2 Jim 22 1.78 
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3€, ContentProvider 可 以 提供 多 个 数据 集 ,调用 者 使 用 URI 对 不 同 的 数据 集 的 数据 进 
行 操作 。 

URI 是 通用 资源 标志 符 (Uniform Resource Identifier) ,用 来 定位 任何 远程 或 本 地 的 
可 用 资源 。ContentProvider 使 用 的 URI 语法 结构 如 下 : 


content://< authority> /< data path> /< id> 


其 中 ,content:// 是 通用 前 级 ,表示 该 URI 用 于 ContentProvider 定位 资源 ,无 需 修改 。 
一 authority 过 是 授权 者 名 称 , 用 来 确定 具体 由 哪 一 个 ContentProvider 提供 资源 。 因 此 ， 
一 般 过 authority 之 都 由 类 的 小 写 全 称 组 成 ,以 保证 唯一 性 。 志 data_path 之 是 数据 路 径 ， 
用 来 确定 请 求 的 是 哪个 数据 集 。 如 果 ContentProvider 仅 提供 一 个 数据 集 , 数 据 路 径 则 
是 可 以 省 略 的 。 但 如 果 ContentProvider 仅 提 供 多 个 数据 集 , 数 据 路 径 则 必须 指明 具体 
是 哪 一 个 数据 集 。 数 据 集 的 数据 路 径 可 以 写成 多 段 格 式 , 例如 /people/girl 和 
/people/boy。 达 id 放 是 数据 编号 ,用 来 唯一 确定 数据 集中 的 一 条 记录 ,用 来 匹配 数据 集中 
ID 字段 的 值 。 如 果 请 求 的 数据 并 不 只 限于 一 条 数据 , 则 二 id 二 是 可 以 省 略 的 。 
例如 ,请 求 整个 people 数据 集 的 URI 应 写 为 : 


content ://edu.hrbeu.peopleprovider/people 
而 请 求 people 数据 集中 第 3 条 数据 的 URI 则 应 写 为 : 


content ://edu.hrbeu.peopleprovider/people/3 
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程序 开发 人 员 通 过 继承 ContentProvider 类 可 以 创建 一 个 新 的 数据 提供 者 ,过 程 可 
以 分 为 三 步 : 

(1) 继承 ContentProvider, Jf HA 6 个 函数 。 

(2) 声明 CONTENT_URI, 实 现 UriMatcher。 

(3) 注册 ContentProvider。 

下 面 按照 上 述 的 三 个 步骤 ,逐步 说 明 创 建 数据 提供 者 的 过 程 。 


1. 继承 ContentProvider ,并 重 载 6 个 函数 


新 建立 的 类 继承 ContentProvider 后 ,共有 6 个 函数 需要 重 载 ,分 别 是 delete O, 
getTypeO \insert() ,onCreateO .qurey() 和 update()。 其 中 ,delete() Vinsert() .qurey() 
和 update() 分 别 用 于 对 数据 集 的 删除 添加、 查询 和 更 新 操作 ,程序 开发 人 员 根 据 底层 数 
据 的 存储 方式 不 同 , 使 用 不 同方 式 实现 数据 操作 函数 。 而 onCreate() 一 般 用 来 初始 化 底 
层 数 据 集 和 建立 数据 连接 等 工作 。getType() 函 数 用 来 返回 指定 URI 的 MIME 数据 类 
型 ,如果 URI 是 单条 数据 , 则 返回 的 MIME 数据 类 型 应 以 vnd. android. cursor. item JF 
头 ; 如 果 URI 是 多 条 数据 , 则 返回 的 MIME 数据 类 型 应 以 vnd. android. cursor. dir/ 
Ts 

新 建立 的 类 继承 ContentProvider 后 ,Eclipse 会 提示 程序 开发 人 员 需 要 重 载 部 分 代 
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码 , 并 自动 生成 需要 重 载 的 代码 框架 。 下 面 的 代码 是 Eclipse 自动 生成 的 代码 框架 : 


1 import android.content. * ; 
2 import android.database .Cursor; 
3 import android.net Uri; 
4 
5 public class PeopleProvider extends ContentProvider{ 
6 
y @ Override 
8 public int delete (Uri uri, String selection, String[] selectionArgs) { 
9 // TODO Auto- generated method stub 
0 return 0; 
1 ) 
12 
3 @ Override 
4 public String getType (Uri uri) { 
5 // TODO Auto- generated method stub 
6 return null; 
$ } 
8 
9 @ Override 
20 public Uri insert (Uri uri, ContentValues values) { 
a // TODO Auto- generated method stub 
22 return null; 
23 } 
24 
25 @ Override 
26 public boolean onCreate() { 
27 // TODO Auto- generated method stub 
28 return false; 
29 } 
30 
31 @ Override 
32 public Cursor query (Uri uri, String[] projection, String selection, 
33 String[] selectionArgs, String sortOrder) { 
34 // TODO Auto- generated method stub 
35 return null; 
36 ) 
37 
38 @ Override 
39 public int update (Uri uri, ContentValues values, String selection, 
40 String[] selectionArgs) { 
41 // TODO Auto- generated method stub 
42 return 0; 
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43 } 
4 } 


2. 声明 CONTENT_URI, $I UriMatcher 


在 新 构造 的 ContentProvider 类 中 ,经常 需要 判断 URI 是 单条 数据 还 是 多 条 数据 ,最 
简单 的 方法 是 构造 一 个 UriMatcher。 同 时 ,为 了 便于 判断 和 使 用 URI, 一 般 将 URI 的 授 
权 者 名 称 和 数据 路 径 等 内 容声 明 为 静态 常量 ,并 声明 CONTENT_URI。 

声明 CONTENT URI 和 构造 UriMatcher 的 代码 如 下 : 


1 public static final String AUTHORITY- "edu.hrbeu.peopleprovider"; 

2 public static final String PATH SINGIE- "people/#"; 

3 public static final String PATH MULTIPLE= "people"; 

4 public static final String OONIENT URI STRING- "content ://"+ AUTHORITY+ "/"+ PATH MULTIPLE; 
5 public static final Uri CONTENT URI-Uri.parse (CONTENT URI SIRING); 
6 private static final int MULTIPLE PFOPIE- 1; 

7 private static final int SINGLE PFDPIE- 2; 

8 

9 private static final UriMatcher uriMatcher; 

10 static { 

11 uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 

12 uriMatcher.addURI (AUTHORITY, PATH SINGIE, MULTIPLE FEOPIE); 

13 uriMatcher.addURI (AUTHORITY, PATH MULTIPLE, SINGLE FEOPIE); 


14 } 


代码 第 1 行 声明 了 URI 的 授权 者 名 称 , 第 2 行 声明 了 单条 数据 的 数据 路 径 ,第 3 行 
声明 了 多 条 数据 的 数据 路 径 ,第 4 行 声明 了 CONTENT_URI 的 字符 串 形式 ,第 5 行 则 正 
式 声明 了 CONTENT_URI, 第 6 行 声明 了 多 条 数据 的 返回 代码 ,第 7 行 声明 了 单条 数据 
的 返回 代码 。 第 9 行 声明 了 UriMatcher, 并 在 第 10 行 到 第 13 行 的 静态 构造 函数 中 , 声 
明了 UriMatcher 的 匹配 方式 和 返回 代码 。 其 中 ,第 11 行 UriMatcher 的 构造 函数 中 ， 
UriMatcher. NO MATCH 表示 URI 无 匹配 时 的 返回 代码 。 第 12 行 的 addURIO 函数 
用 来 添加 新 的 匹配 项 ,语法 如 下 : 


public void addURI (String authority, String path, int code) 


其 中 ,authority 表示 匹配 的 授权 者 名 称 ,path 表示 数据 路 径 ,# 可 以 代表 任何 数字 ， 
code 表示 返回 代码 。 

使 用 UriMatcher 时 , 则 可 以 直接 调用 match O 函数 ,对 指定 的 URI 进行 判断 ,示例 
代码 如 下 : 


1 switch (uriMatcher .match (uri)) { 

2 case MULTIPLE PEOPLE: 

3 // 多 条 数据 的 处 理 过 程 
4 break; 
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5 case SINGLE PEOPLE: 

6 // 单 条 数据 的 处 理 过 程 

7 break; 

8 default: 

9 throw new IllegalArgumentException (中 支持 的 URT:"+ uri); 
10 } 


3. 注册 ContentProvider 


在 完成 ContentProvider 类 的 代码 实现 后 ,需要 在 AndroidManifest. xml 文件 中 进行 
注册 。 注 册 ContentProvider 使 用 一 provider 二 标签 ,示例 代码 如 下 : 

1 < application android:icon- "@ drawable/icon" android: label= "@ string/app_name"> 

2 < provider android:name- ".PeopleProvider" 

3 android:authorities- "edu.hrbeu.peopleprovider"/» 

4 < /application» 

在 上 面 的 代码 中 ,注册 了 一 个 授权 者 名 称 为 edu. hrbeu. peopleprovider 的 Content- 
Provider ,其 实现 类 是 PeopleProvider。 


843 使 用 数据 提供 者 


使 用 ContentProvider 并 不 需要 直接 调用 类 中 的 数据 操作 函数 ,而 是 通过 Android 
组 件 都 具有 的 ContentResolver 对 象 ,通过 URI 进行 数据 操作 。 程 序 开发 人 员 只 需要 知 
道 URI 和 数据 集 的 数据 格式 , 则 可 以 进行 数据 操作 ,解决 不 同 应 用 程序 之 间 的 数据 共享 
问题 。 

每 个 Android 组 件 都 具有 一 个 ContentResolver 对 象 ,获取 ContentResolver 对 象 的 
方法 是 调用 getContentResolver( PR äi. 


ContentResolver resolver- getContentResolver () 7 


1. 查询 操作 


在 获取 到 ContentResolver 对 象 后 ,程序 开发 人 员 则 可 以 使 用 query O 函数 查询 目标 
数据 。 下面 的 代码 是 查询 ID 为 2 的 数据 : 


String KEY ID-" id"; 
String KEY NAME- "name"; 
String KEY AGE- "age"; 
String KEY HEIGHT- "height"; 


Uri uri- Uri parse (CONIENT URI STRING "/"4 "2"; 
Cursor cursor- resolver.query (uri, 


new String[] (KEY ID, KEY NAME, KEY AGE, KEY HEIGHT), null, null, null); 
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从 上 面 的 代码 不 难看 出 ,在 URI 中 定义 了 需要 查询 数据 的 ID, Æ query() 函 数 并 没 
有 额外 声明 查询 条 件 。 如 果 需 要 获取 数据 集中 的 全 部 数据 , 则 可 直接 使 用 CONTENT _ 
URI, 此 时 ContentProvider 在 分 析 URI 时 将 认为 需要 返回 全 部 数据 。 

ContentResolver 的 query() 函 数 与 SQLite 数据 库 的 query() 函 数 非常 相似 ,语法 结 
构 如 下 : 


Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 


uri 定 义 了 查询 的 数据 集 ,projection 定义 了 从 数据 集 返 回 哪些 数据 项 , selection 定 
义 了 返回 数据 的 查询 条 件 。 


2. 添加 操作 


向 ContentProvider 中 添加 数据 有 两 种 方法 ,一 种 是 使 用 insert CO PR RK. 向 
ContentProvider 中 添加 一 条 数据 ; 另 一 种 是 使 用 bultInsert() 函 数 , 批 量 添 加 数据 。 下 面 
的 代码 说 明了 如 何 使 用 insert() 函 数 添加 单条 数据 : 


ContentValues values= new ContentValues () ; 
values.put(KEY NAME, "Tom"); 
values.put(KEY AGE, 21); 

values.put(KEY HEIGHT, 1.81f); 
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Uri newUri= resolver.insert (CONTENT URI, values); 
下 面 的 代码 说 明了 如 何 使 用 bultInsert O AZORIN ABH s 


1 ContentValues[] arrayValues- new ContentValues [10]; 
2 /实例 化 每 一 个 ContentValues 
3 int count- resolver.bultInsert (OONTENT URI, arrayValues); 


3. 删除 操作 


删除 操作 需要 使 用 delete() 函 数 。 如 果 需 要 删除 单条 数据 , 则 可 以 在 URI 中 指定 需 
要 删除 数据 的 ID。 如 果 需 要 删除 多 条 数据 , 则 可 以 在 selection 中 声明 删除 条 件 。 下 面 
代码 说 明了 如 何 删除 ID 为 2 的 数据 : 


1 Uri uri=Uri.parse (CONTENT URI SIRING "/"+ "2") ; 
2 int result- resolver.delete (uri, null, null); 


也 可 以 在 selection 将 删除 条 件 定义 为 ID 大 于 4 的 数据 : 


工 String selection- KEY IDt "> 4"; 
2 int result- resolver.delete (OONTENT URI, selection, null); 


4. 更 新 操作 
更 新 操作 需要 使 用 update() 函 数 ,参数 定义 与 delete() 函 数 相同 ,同样 可 以 在 URI 
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中 指定 需要 更 新 数据 的 ID, 也 可 以 在 selection 中 声明 更 新 条 件 。 下 面 代码 说 明了 如 何 
更 新 ID 为 7 的 数据 : 

1 ContentValues values- new ContentValues () ; 

2 values.put(KEY NAME, "Toam"); 

3 values.put(KEY AGE, 21); 

4 values.put(KEY HEIGHT, 1.81f); 

5 

6 

7 


Uri uri=Uri.parse (OONTENT URI SIRING "/"+ "7"); 
int result= resolver.update (uri, values, null, null); 


844 示例 


ContentProviderDemo 是 一 个 无 界面 的 示例 , 仅 提供 一 个 ContentProvider 组 件 , 供 
其 他 应 用 程序 进行 数据 交换 。 底 层 使 用 SQLite 数据 库 ,支持 数据 的 添加 .删除 .更 新 和 查 
询 等 基本 操作 。ContentResolverDemo 是 使 用 


D ab 12:41pm 
ContentProvider 的 示例 ,自身 不 具有 任何 数据 存储 ContentkesolverDema 
功能 , 仅 是 通过 URI 访问 ContentProviderDemo jimmy 
示例 提供 的 ContentProvider。 界 面 如 图 8. 16 所 2 


示 ,该 界面 与 SQLiteDemo 示例 的 界面 基本 相同 。 
从 图 8.17 的 文件 结构 上 可 以 发 现 ,两 个 示例 Bitten 

都 包含 一 个 相同 的 文件 People. java 两 个 示例 中 。 国 一 

的 这 个 文件 的 内 容 也 完全 相同 ,定义 了 数据 提供 者 Le Less Less 

和 数据 调用 者 都 必须 知道 的 信息 。 这 些 信息 包括 i 

HAK i BOE EG, MIME 数据 类 型 、 

CONTENT_URI 和 数据 项 名 称 等 。 
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8.16  ContentResolverDemo 用 户 界面 


GS ContentProviderDemo GES ContentResolverDemo 
ERC src ER sre 
E- edu. hrbeu ContentProviderDeno D BB edu hrbeu ContentResolverDeno 
Di People. java 由 - 国 ContentResolverDeno. java 
由 - 国 PeopleProvider. java DD People. java 
人 gen [Generated Java Files] D Ep gen [Generated Java Files] 
GB Android 1.5 DS Android 1.5 
GS assets Gs assets 
日 色 res BE» res 
DC drawable @-G drawable 
CG layout SES layout 
DC values 国 main xnl 
EI Andrei dan) fest. xml @ values 
= B default. properties EI Androi Manifest. xml 


图 8.17 ContentProviderDemo 和 ContentResolverDemo 文件 结构 
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下 面 分 别 给 出 People. java、PeopleProvider. java 和 ContentResolverDemo. java 的 完 
整 代 码 , 最 后 分 别 给 出 ContentProviderDemo 示例 和 ContentResolverDemo 示例 的 
AndroidManifest. xml 文件 内 容 。 

People. java 文件 的 完整 代码 如 下 : 


package edu.hrbeu.ContentResolverDemo; 
import android.net .Uri; 


public class People{ 
lic static final String MIME DIR_PREFIX= "vnd.android.cursor.dir"; 


lic static final String MME ITEM PREFTX- "vrd.android.cursor.item"; 
lic static final String MINE ITEM- "vnd.hrbeu.people"; 
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lic static final String MINE TYPE SINGIE-MIME ITEM PREFTX+ "/"+ MINE TTEM; 
lic static final String MINE TYPE MULTIPIE-MIME DIR PREFIX+ "/"+ MINE ITEM; 


lic static final String AUTHORITY- "edu.hrbeu.peopleprovider"; 

lic static final String PATH SINGIE- "people/# "; 

lic static final String PATH MJLTIPIE- "people"; 

lic static final String OONTENT URI STRING= "content ://"+ AUTHORITY+ "/"+ PATH MULTIPLE; 
lic static final Uri OONTENT_URI= Uri.parse (CONTENT URI STRING); 


Lic static final String KEY ID-" id"; 

lic static final String KEY NAME- "name"; 

lic static final String KEY AGE- "age"; 
public static final String KEY HEIGHT- "height"; 


EER EEEEE BR EEF 


SN 


23 } 
PeopleProvider. java 文件 的 完整 代码 如 下 : 


package edu.hrbeu.ContentProviderDamo; 


import android.content .ContentProvider; 

import android.content .ContentUris; 

import android.content .ContentValues; 

import android.content.Context; 

import android.content.UriMatcher; 

import android.database.Cursor; 

import android.database.SQLException; 

import android.database.sqlite.SQLiteDatabase; 

11 import android.database.sqlite.SQLiteOpenHelper; 
12 import android.database.sqlite.SQLiteQueryBuilder; 
13 import android.database.sqlite.SQLiteDatabase.CursorFactory; 
14 import android.net.Uri; 
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16 public class PeopleProvider extends ContentProvider{ 


18 private static final String DB NAM "people.do"; 

19 private static final String DB TABIE- "peopleinfo"; 

20 private static final int DB VERSIONF 1; 

21 

22 private SQLiteDatabase db; 

23 private DBOpenHelper doopentelper; 

24 

25 private static final int MULTIPLE PHOPLE= 1; 

26 private static final int SINGLE PFDPIE- 2; 

21 private static final UriMatcher uriMatcher; 

28 

29 static ( 

30 uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 

a uriMatcher.addURI (People AUTHORITY, Pecple.PATH MULTIPLE, MULTIPLE PEOPIE); 
32 uriMatcher.addURI (People AUTHORITY, People.PATH SINGLE, SINGLE PFOPIE); 
33 } 

34 

35 @ Override 

36 public String getType (Uri uri) { 

37 switch (uriMatcher .match (uri) ) ( 

38 case MULTIPLE PFOBIE: 

39 return People.MINE TYPE MULTIPLE; 

40 case SINGLE PEOPLE: 

4l return People.MINE TYPE SINGLE; 

42 default: 

43 throw new IllegalArgumentException ("Unkown uri:"+ uri); 
44 } 

45 } 

46 

47 @ Override 

48 public int delete (Uri uri, String selection, String[] selectionArgs) { 
49 int count= 0; 

50 switch (uriMstcher match (uri) ) { 

51 case MULTIPLE PHOPLE: 

52 count= db.delete (DB TABIE, selection, selectionArgs) ; 
53 break; 

54 case SINGLE PEOPLE: 

55 String segment= uri.getPathSegments () .get (1) ; 

56 count= db.delete (IB TABIE, People.KEY ID+ "="+ segment, selectionArgs) ; 
PI break; 

58 default: 


59 throw new TllegalArgurentException ("Unsugported URI:"+ uri); 
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} 
getContext () .getContentResolver () .notifyChange (uri, null); 
return count; 


@ Override 

public Uri insert Uri uri, ContentValues values) { 
long id= db.insert (DB TABIE, null, values); 
if (id>0){ 


Uri newUri= ContentUris.with/gpendedId (Peqple CONTENT URI, id); 
getContext () .getContentResolver () .notifyChange (newUri, null); 


return newUri; 
) 
throw new SQLException ("Failed to insert row into "+ uri); 


@ Override 
public boolean onCreate() { 
Context context- getContext () ; 


dbOpenHelper= new DBOpenHelper(context, DB NAME, null, DB VERSION); 


do- dbOpenHelper .getWritableDatabase () ; 


if zm) 
return false; 
else 
return true; 


@ Override 


public Cursor query (Uri uri, String[] projection, String selection, 


String[] selectionArgs, String sortOrder) ( 
SQLiteQueryBuilder qb= new SQLiteQueryBuilder(); 
do.setTables (DB TABIE); 
switch (uriMatcher match (uri) ) ( 

case SINGLE, PEOPLE: 


do.appendWhere (People KEY ID+ "= "+ uri.getPathSegments () .get (1)) ; 


break; 
default: 
break; 

} 

Cursor cursor- qb.query (db, 
projection, 
selection, 
selectionArgs, 
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null, 
null, 
sortOrder) ; 
cursor. setNoti ficationUri (getContext () .getContentResolver(), uri); 


return cursor; 


@ Override 
public int update (Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
int count; 
switch (uriMatcher .match (uri) ) { 
case MULTIPLE PEOPLE: 
count= db. update (IB TRIE, values, selection, selectionArgs) ; 
break; 
case SINGLE PEOPLE: 
String segment- uri.getPathSegments () .get (1) ; 
count- db. update (IB TABLE, values, People. KEY ID +"="+ segment, 
selectionArgs) ; 
break; 
default: 
throw new IllegalArgumentException ("Unknow URI:" uri); 
} 
getContext () .getContentResolver () .notifyChange (uri, null); 
return count; 


private static class DBOpenHelper extends SQLiteOpenHelper ( 


public DBOpenHelper (Context context, String name, CursorFactory factory, int 
version) { 


super (context, name, factory, version); 


private static final String DB CREATE- "create table "+ 
IB _TABLE+ " ("+ People.KEY IDt" integer primary key autoincrement, "+ 
People. KEY NAME+" text not null, "+ People.KEY AGE+" integer, "+ People. EY ` 
HEIGHT+ " float) ;"; 


@ Override 
public void onCreate(SQLiteDatabase db) { 
. do.execSQL(DB CREATE); 
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145 

146 @ Override 

147 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
148 . db.execSQL("TROP TABLE IF EXISTS "+ DB TABIE) ; 

149 onCreate( do); 

150 ) 

151 } 

152} 


ContentResolverDemo. java 文件 的 完整 代码 如 下 : 


1 package edu.hrbeu.ContentResolverDemo; 
2 
3 
4 import android.app.Activity; 
5 import android.content .ContentResolver; 
6 inport android.content .ContentValues; 
7 import android.database.Cursor; 
8 import android.net.Uri; 
9 import android.os.Bundle; 
0 import android.view.View; 
1 import android.view.View.OnClickListener; 
D import android.widget.Button; 
3 import android.widget.EditText; 
4 import android.widget.TextView; 
5 
6 public class ContentResolverDemo extends Activity { 
7 
8 private EditText nameText; 
9 private EditText ageText; 
20 private EditText heightText; 
21 private EditText idEntry; 
22 
23 private TextView labelView; 
24 private TextView displayView; 
25 
26 private ContentResolver resolver; 
27 
28 @ Override 
29 public void onCreate (Bundle savedInstanceState) { 
30 super .onCreate (savedInstanceState) ; 
3l setContentView (R. layout .main) ; 
32 
33 nameText- (EditText) findViewById (R.id.name) ; 
34 ageText- (EditText) findViewByld (R.id.age) ; 
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35 heightText= (EditText) findViewByld (R.id-height) ; 

36 idEntry- (EditText) findViesById(R.id.id entry); 

3 

38 labelView- (TextView)findViewById(R.id.label) ; 

39 displayView= (TextView) findViewByTd (R. id.di splay); 

40 

4 

42 

43 Button addButton= (Button) findViesById (R. id.add) ; 

44 Button queryAllBatton- (Button) findViewById (R.id.query all); 
45 Button clearButton= (Button) findViewById(R.id.clear); 

46 Button deleteALIButton= (Button) findViewById(R.id.delete all); 
47 

48 Button queryButton= (Button) findViewById (R. id.query) ; 

49 Button deleteButton= (Button) findViewByld (R.id.delete) ; 

50 Button updateButton- (Button) findViewByld (R. id.update) ; 

51 


52 

53 addButton.setOnClickListener (addButtonListener) ; 

54 queryAllButton.setOnClickListener (queryAllButtonListener) ; 
55 clearButton.setOnClickListener (clearButtonListener) ; 

56 deleteAllButton.setOnClickListener (deleteAllButtonListener); 


57 

58 queryButton.setOnClickListener (queryButtonListener) ; 

59 deleteButton.setOnClickListener (deleteButtonListener) ; 

60 updateButton.setOnClickListener (updateButtonListener) ; 

6l 

62 resolver- this.getContentResolver () ; 

63 

6 } 

65 

66 

67 OnClickListener addButtonListener- new OnClickListener() { 

68 € Override 

69 public void onClick (View v) { 

70 ContentValues values- new ContentValues () 7 

3t 

P values -put (People.KEY NAME, nameText.getText () -toString ()); 

D values .put (Peqple.KEY ME, Integer.parseInt (ageText text () 
-toString0)) ; 

7A values.put(People.KEY HEIGHT, Float.parseFloat (heightText. getText () . toString 
0); 

75 


76 Uri newUri= resolver.insert (People.CONTENT URI, values); 
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labelView.setText ("添加 成 功 ,URI:"+ newUri) 7 


IE 


OnClickListener queryAl]ButtonListener= new OnClickListener() ( 
@ Override 
public void onClick (View v) { 
Cursor cursor- resolver .query (People.CONTENT_URI, 
new String[] { People.KEY ID, People.KEY_NAME, People.KEY AGE, People. 
KEY HEIGHT), 
null, null, null); 
if (cursor-- null)( 
labelView.setText ("CGR PE PBS 6 SR. 
return; 
) 
labelView.setText (数据 库 : "+ String. vallueOf (cursor.getCount ())+ A i3 ") ; 


if (cursor.moveToFirst ()) ( 

dot 
msg+="ID; "+ cursor.getInt (cursor.getColumnIndex (Peopble.KEY ID))+ ","; 
mot = " 姓 名 "+ cursor. getString (cursor. getColumIndex (People. KEY ` 
NAME) ) t ","; 
msgt- "年 龄 "+ cursor.getInt (cursor.getColumnIndex (Pecople.KEY MEI) 
gn 
msgt =" 身 高 : "+ cursor. getFloat (cursor.getColumIndex (People. KEY ` 
HEIGHT) \n"; 

}while (cursor .moveToNext () ) 7 


displayView.setText (msg) ; 
E 
OnClickListener clearButtonListener- new OnClickListener() { 
@ Override 
public void onClick (View v) { 
displayView.setText (""); 


E 
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OnClickListener deleteAllButtonListener- new OnClickListener() { 
@ Override 
public void onClick (View v) { 
resolver .delete (People.OONTENT URI, null, null); 
String msg- "CHE 4 BM BE" ; 
labelView.setText (msg) ; 


n 


OnClickListener queryButtonListener- new OnClickListener() ( 
@ Override 
public void onClick (View v) { 
Uri uri= Uri .parse (People.CONTENT_URI_STRING+ "/"+ idEntry.getText () .toString() ) ; 
Cursor cursor- resolver .query (uri, 
new String[] ( People.KEY ID, People.KEY NAME, People.KEY AGE, People. 
KEY HEIGHT), 
null, null, null); 
if (cursor-- null)( 
labelView.setText ("数据 库 中 没有 数据 "); 
return; 


if (cursor.moveToFirst ()) ( 
msg+ = "ID: "+ cursor.getInt (cursor.getColumiIndex(Pecple.KEY ID))- ","; 
mot = "姓名 : "+ cursor.getString (cursor.getColumIndex(Pecople.KEY NAME))4- 
mot — "年 龄 "+ cursor.get Int (cursor.getColumIndex(People.KEY ACE))-*", "; 
mot — "Epi. "+ cursor.getFloat (cursor.getColumnIndex (Pecople.KEY HEIGHT)) 
+"\n"; 


labelView.setText (SCHR FE: "); 
displaywWiew.setText (msg) ; 


he 


OnClickListener deleteButtonListener- new OnClickListener() { 
@ Override 
public void onClick (View v) { 


Uri uri= Uri .parse (People.OONTENT URI SIRING "/"+ idEntry.getText () .toString()) ; 
int result- resolver.delete (uri, null, null); 
String msg- "Ill BE ID Jy "+ idEntry.getText () toString ()+ "的 数据 "+ (result> 02 "Jl 
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jp": n); 
labelView.setText (msg) ; 


OnClickListener updateButtonListener= new OnClickListener() { 
G Override 
public void onClick(View v) ( 
ContentValues values- new ContentValues () ; 


values.put (People.KEY NAME, nameText.getText () .toString()) ; 

values.put (Pecple.KEY AGE, Integer.parselnt (ageText .get'Ext: () 

-toString())); 

values.put (People. KEY HEIGHT, Float. parseFloat (heightText. getText () . toString 
0); 


Uri uri= Uri .parse (People.CONTENT_URI_STRING+ "/"+ idEntry.getText () .toString()); 
int result- resolver.update (uri, values, null, null); 


String msg- "E Dr ID Jy "+ idEntry.getText () .toString ()+ "的 数据 叶 (result> 02 "Jl 
3j nm. Wr my ; 
labelView.setText (msg) ; 
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ContentProviderDemo 示例 的 AndroidManifest. xml 文件 内 容 : 


<?xml version "1.0" encoding- "utf- 8"?» 
«manifest xmlns:android- "http: //schemas .android.can/apk/res/android" 
android:versionCode- "1" 
android:versionName- "1.0" 
< application android:icon- "Q drawable/icon" android:label- "@ string/app name" 
< provider android:name- ".PeopleProvider" 
android:authorities- "edu.hrbeu.peopleprovider"/» 
< application» 
10 < uses- sdk android:minSdkVersion- "3" /> 
11  «/manifest^ 


eC o A eo 0 e Lu H ro 


ContentResolverDemo 7 (DÉI Android Manifest. xml 文件 内 容 : 


1 <?xml versione "1.0" encoding- "utf- 8"?» 

2 «manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 

3 package "edu.hrbeu.ContentResolverDemo" 

4 android:versionCode- "1" 

5 android:versionName- "1.0"> 

6 < application android:icon- "@ drawable/icon" android:label- "8 string/app name"? 
7 «activity android:name- ".ContentResolverDemo" 

8 android:label- "6 string/app name" 

9 < intent- filter» 

10 < action android:name- "android. intent .action.MAIN" /> 

11 < category android:name= "android.intent.category.LAUNCHER" /> 
12 < /intent- filter» 

13 < /activity> 

14 < /agplication> 

15 « uses- sdk android:minSdkVersion- "3" /> 


16  «/manifest^ 
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1. 应 用 程序 一 般 允 许 用 户 自 己 定义 配置 信息 ,如 界面 背景 颜色 .字体 大 小 和 字体 颜 
色 等 ,尝试 使 用 SharedPreferences 保存 用 户 的 自 定义 配置 信息 ,并 在 程序 启动 时 自动 加 
载 这 些 自 定义 的 配置 信息 。 

2. 尝试 把 第 1 题 的 用 户 自己 定义 配置 信息 ,以 INI 文 件 的 形式 保存 在 内 部 存储 
器 上 。 

3. 简 述 在 嵌入 式 系统 中 使 用 SQLite 数据 库 的 优势 。 

4. 分 别 使 用 手动 建 库 和 代码 建 库 的 方式 ,创建 名 为 test. db 的 数据 库 , 并 建立 staff 
数据 表 , 表 内 的 属性 值 如 表 8. 8 所 示 。 


表 8.8 staff 表 属 性 值 
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属 性 数据 类 型 说 有 明 
_id integer 主键 
name text 姓名 
Sex text 性 别 
department text 所 在 部 门 
salary float TE 


5. 利用 第 4 题 所 建立 的 数据 库 和 staff 表 , 为 程序 提供 添加 、 删 除 和 更 新 等 功能 ,并 


尝试 将 表 8.9 中 的 数据 添加 到 staff KP. 


表 8.9  peopleinfo ZS P3 SS 


_id name sex department salary 
1 Tom male computer 5400 
2 Einstein male computer 4800 
3 Lily female 1.68 5000 
4 Warner male 
5 Napoleon male 


6. 建立 一 个 ContentProvider ,用 来 共享 第 4 题 所 建立 的 数据 库 。 


第 9 = €) c oo 
位 置 服务 与 地 图 应 用 


位 置 服务 和 地 图 应 用 是 发 展 最 为 迅速 ` 有 着 大 量 潜在 需求 的 领域 ,通过 本 章 的 学 习 
可 以 让 读者 简单 地 了 解 位 置 服 务 和 地 图 应 用 的 概念 .方法 和 技巧 。 读 者 可 以 使 用 Google 
提供 的 地 图 服务 ,构建 提供 位 置 服务 的 应 用 程序 。 

本 章 学 习 目 标 : 

。 了 解 位 置 服务 的 概念 

。 了 解 地 图 密 钥 的 申请 方法 

。 掌握 获取 位 置信 息 的 方法 

* 掌握 MapView 和 MapController 的 使 用 方法 

* 'É3E Google 地 图 窗 盖 层 的 使 用 方法 
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位 置 服务 (Location Based Services. LBS) ,又 称 定位 服务 或 基于 位 置 的 服务 ,融合 了 
GPS 定位 、 移 动 通信 、 导 航 等 多 种 技术 ,提供 了 与 空间 位 置 相关 的 综合 应 用 服务 。 位 置 服 
务 首先 在 日 本 得 到 商业 化 的 应 用 。2001 年 7 月 ,DoCoMo 发 布 了 第 一 款 具 有 三 角 定 位 功 
能 的 手持 设备 ,2001 年 12 H . KDDI 发 布 第 一 款 具 有 GPS 功能 的 手机 。 近 些 年 来 ,基于 
位 置 的 服务 发 展 更 加 迅速 ,涉及 到 商务 医疗. 工作 和 生活 等 各 个 方面 ,为 用 户 提供 定位 、 
追踪 和 敏感 区 域 警告 等 一 系列 服务 。 

Android 平台 支持 提供 位 置 服务 的 API, 在 开发 过 程 中 主要 用 到 LocationManager 
和 LocationProviders 对 象 。 

LocationManager 可 以 用 来 获取 当前 的 位 置 ,追踪 设备 的 移动 路 线 , 或 设 定 敏感 区 
域 ,在 进入 或 离开 敏感 区 域 时 设备 会 发 出 特定 警报 。LocationProviders 则 是 能 够 提供 定 
位 功能 的 组 件 集合 ,集合 中 的 每 种 组 件 以 不 同 的 技术 提供 设备 的 当前 位 置 , 区 别 在 于 定 
位 的 精度 、 速 度 和 成 本 等 方面 。 

为 了 使 开发 的 程序 能 够 提供 位 置 服务 ,首先 需要 获得 LocationManager 对 象 。 获 取 
LocationManager 可 以 通过 调用 android. app. Activity. getSystemService() PA ŽK IM , 代 
码 如 下 : 
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1 String serviceString- Context LOCATION SERVICE; 

2 LocationManager LocatiorManager- (LocatiorManager) getSystemService (serviceString) ; 

代码 第 2 行 的 getSystemServiceO PARC. n] VAAL HER PRIX Android 提供 的 系 
统 级 服务 。 代 码 第 1 行 的 Context. LOCATION. SERVICE 指明 获取 的 服务 是 位 置 服 
务 。Android 支持 的 系统 级 服务 如 表 9. 1 所 示 。 


表 9.1 Android 支持 的 系统 级 服务 
Context 类 的 静态 常量 值 返回 对 象 说 OB 
LOCATION_SERVICE location LocationManager 控制 位 置 等 设备 的 更 新 
WINDOW_SERVICE window WindowManager 最 顶层 的 窗口 管理 器 


LAYOUT INELATER layout_inflater | LayoutInflater 将 AM, KNEW 
_SERVICE 为 View 
POWER_SERVICE power PowerManager 电源 管理 
ALARM_SERVICE alarm AlarmManager 在 指定 时 间接 受 Intent 
NOTIFICATION SERVICE | notification NotificationManager 后 台 事 件 通知 
KEYGUARD_SERVICE keyguard KeyguardManager 锁定 或 解锁 键盘 
SEARCH_SERVICE search SearchManager 访问 系统 的 搜索 服务 
VIBRATOR_SERVICE vibrator Vibrator 访问 支持 振动 的 硬件 
CONNECTIVITY_SERVICE | connection ConnectivityManager 网 络 连接 管理 

WIFI SERVICE wifi WifiManager Wi-Fi 连接 管理 
INPUT METHOD SERVICE | input method | InputMethodManager | 输入 法 管理 


在 获取 到 LocationManager 后 ,还 需要 指定 LocationManager 的 定位 方法 ,然后 才能 
够 调用 LocationManager. getLastKnowLocation ( ) 方法 获取 当前 位 置 。 目 前 
LocationManager 支持 的 定位 方法 有 两 种 ,分 别 是 使 用 GPS 定位 和 使 用 网 络 定位 。GPS 
定位 可 以 提供 更 加 精确 的 位 置信 息 , 但 定位 速度 和 质量 受到 卫星 数量 和 环境 情况 的 影 
响 ; 网 络 定位 提供 的 位 置信 息 精 度 较 差 , 但 速度 较 GPS 定位 快 。LocationManager 支持 


定位 方法 参考 表 9. 2。 


表 9.2 LocationManager 支持 定位 方法 


LocationManager 
类 的 静态 常量 
s 使 用 GPS 定位 ,利用 卫星 提供 精确 的 位 置信 息 ,需要 android. 
SEET [ps permissions. ACCESS_FINE_LOCATION 用 户 权限 
NETWORK 使 用 网 络 定位 ,利用 基站 或 Wi-Fi 提供 近似 的 位 置信 息 ,需要 具有 
PROVIDER network | 如 下 权限 android. permission. ACCESS COARSE LOCATION 或 
android. permission. ACCESS FINE LOCATION. 


在 指定 LocationManager 的 定位 方法 后 , 则 可 以 调用 getLastKnowLocation O 77 i 


198 


人 six 


获取 当前 的 位 置信 息 。 以 使 用 GPS 定位 为 例 , 获 取 位 置信 息 的 代码 如 下 : 

1 String provider- LocatiorManager.GPS PROVIDER; 

2 Location location= locationManager .getLastKnownLocation (provider) ; 

代码 第 2 行 返回 的 Location 对 象 中 ,包含 了 可 以 确定 位 置 的 信息 ,如 经 度 、 纬 度 和 速 
度 等 ,用 户 可 通过 调用 Location 中 的 getLatitude() 和 getLonggitude() 方 法 分 别 获 取 位 
置信 息 中 的 纬度 和 经 度 , 示 例 代码 如 下 : 


3 double lat- location.getlatitude(); 
2 double 1ng- location.getLongitude () ; 


在 很 多 提供 定位 服务 的 应 用 程序 中 ,不 仅 需要 获取 当前 的 位 置信 息 ,还 需要 监视 位 
置 的 变化 ,在 位 置 改变 时 调用 特定 的 处 理 方法 。LocationManager 提供 了 一 种 便捷 、 高 效 
的 位 置 监视 方法 requestLocationUpdates() ,可 以 根据 位 置 的 距离 变化 和 时 间 间 隔 设 定 
产生 位 置 改变 事件 的 条 件 , 这 样 可 以 避免 因 微小 的 距离 变化 而 产生 大 量 的 位 置 改变 事 
件 。LocationManager 中 设 定 监 听 位 置 变化 的 代码 如 下 : 


locationManager . requestLocationUpdates (provider, 2000, 10, locationListener); 


第 1 个 参数 是 定位 的 方法 ,GPS 定位 或 网 络 定位 ;第 2 个 参数 是 产生 位 置 改变 事件 
的 时 间 间 隔 ,单位 为 微 秒 ;第 3 个 参数 是 距离 条 件 , 单 位 是 米 ; 第 4 个 参数 是 回调 函数 ,是 
在 满足 条 件 后 的 位 置 改 变 事件 的 处 理 函数 。 上 面 的 代码 将 产生 位 置 改 变 事件 的 条 件 设 
定 为 距离 改变 10 米 , 时 间 间 隔 为 2 秒 。 实 现 locationListener 的 代码 如 下 : 
1 LocationListener locationListener- new LocationListener () { 
2 public void onLocationChanged (Location location) { 
3 ) 
4 public void onProviderDisabled(String provider) { 
5 ) 
6 
7 
8 
9 


public void onProviderEnabled (String provider) ( 

) 

public void onStatusChanged(String provider, int status, Bundle extras) ( 
) 

10 k 


代码 第 2 行 的 onLocationChanged () 在 设备 的 位 置 改变 时 被 调用 ;第 4 行 的 
onProviderDisabled ( ) 在 用 户 禁 用 具有 定位 功能 的 硬件 时 被 调用 ;第 6 行 的 
onProviderEnabled € ) 在 用 户 启 用 具有 定位 功能 的 硬件 时 被 调用 :第 8 行 的 
onStatusChanged() 在 提供 定位 功能 的 硬件 的 状态 改变 时 被 调用 ,如 从 不 可 获取 位 置信 
息 状 态 到 可 以 获取 位 置信 息 的 状态 ,反之 亦 然 。 

最 后 ,为 了 使 GPS 定位 功能 生效 ,还 需要 在 AndroidManifest. xml 文件 中 加 入 用 户 
许可 ,代码 如 下 : 


< uses- permission android:name- "android.permission.AOCESS FINE IOCATION"/> 
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CurrentLocationDemo 是 一 个 提供 位 置 服务 的 基本 示例 ,提供 了 显示 当前 位 置 新 的 
功能 ,并 能 够 监视 设备 的 位 置 变化 。CurrentLocationDemo 的 用 户 界面 如 图 9. 1 所 示 。 

位 置 服务 一 般 都 需要 使 用 设备 上 的 硬件 ,最 理想 的 调试 方式 是 将 程序 上 传 到 物理 设 
备 上 运行 ,但 在 没有 物理 设备 的 情况 下 ,也 可 以 使 用 Android 模拟 器 提供 的 虚拟 方式 模 
拟 设备 的 位 置 变化 ,调试 具有 位 置 服务 的 应 用 程序 。 首 先 打 开 DDMS 中 的 模拟 器 控制 ， 
在 Location Controls 中 的 Longitude 和 Latitude 部 分 输入 设备 当前 的 经 度 和 纬度 ,然后 
单 击 Send 按钮 ,就 将 虚拟 的 位 置信 息 发 送 到 Android 模拟 器 中 ,如 图 9.2 所 示 。 

Kom 

@decinal 


OSexagesimal 
Longi tude [-122. 084095 


oo © all 02:58 


CurrentLocationDemo 


Latitude |37. 422006 


9.1 CurrentLocationDemo 示例 界面 9.2 模拟 器 控制 器 


在 程序 运行 过 程 中 ,可 以 在 模拟 器 控制 器 中 改变 经 度 和 纬度 坐标 值 ,程序 在 检测 到 
位 置 的 变化 后 ,会 将 最 新 的 位 置信 息 显 示 在 界面 上 。 但 笔者 在 1. 5 版 本 的 Android 模拟 
器 中 进行 调试 时 ,发 现 模拟 器 控制 器 只 能 成 功 地 将 虚拟 坐标 发 送 到 模拟 器 中 2 次 ,超过 2 
次 后 模拟 器 对 新 发 送 的 虚拟 坐标 不 再 响应 。 

下 面 给 出 CurrentLocationDemo 示例 中 LocationBasedServiceDemo. java 文件 的 完 


整 代码 : 


1 package edu.hrbeu.TocationBasedServiceDemo; 

2 

3 import android.app.Activity; 

4 import android.content .Context; 

5 import android.os.Bundle; 

6 import android.widget.TextView; 

7 import android.location.Location; 

8 import android.location.LocationListener; 

9 import android.location.locationManager; 

10 

11 public class LocationBasedServiceDemo extends Activity { 
12 @ Override 

13 public void onCreate (Bundle savedInstanceState) { 

14 super .onCreate (savedInstanceState) ; 

15 setContentView (R. layout .main) ; 

16 

17 String serviceString=Context LOCATION SERVICE; 
18 LocationManager locationManager= (LocationManager) getSystemService (serviceString) ; 
19 String provider= locationManager.GPS PROVIDER; 


20 Location location= locationManager .getl astKnownl ocaticn (provider) ; 


200 


人 six 


21 getLocationInfo (Location) ; 

22 locationManager .requestLocationUpdates (provider, 2000, 0, locationListener); 
23 } 

24 

25 private void getlocationInfo (Location location) { 

26 String latLongInfo; 

27 TextView locationText- (TextView) findViewByld (R.id.txtshow) ; 
28 if (location !=null) { 

29 double lat= location.getLatitude () ; 

30 double 1ng- location.getLongitude () ; 

31 latLongInfo= "Lat: "+ lat+ "\nLong: "+ lng; 

32 } 

3 else{ 

34 latlongInfo- "No location found"; 

35 } 

36 locationText .setText ("Your Current Position is:\n"+ latLongInfo) ; 
37 } 

38 

39 private final LocationListener locationListener= new LocationListener () { 
40 @ Override 

EM public void onLocationChanged (Location location) { 

42 getLocationInfo (location) ; 

43 } 

44 @ Override 

45 public void onProviderDisabled (String provider) { 

46 getLocationInfo (null) ; 

47 } 

48 @ Override 

49 public void onProviderEnabled (String provider) { 

50 getLocationInfo (null) ; 

51 } 

52 @ Override 

53 public void onStatusChanged (String provider, int status, Bundle extras) { 
54 } 

55 IE 

56 ] 
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921 申请 地 图 密 钥 
为 了 在 手机 中 更 直观 地 显示 地 理 信息 ,程序 开发 人 员 可 以 直接 使 用 Google 提供 的 
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地 图 服务 ,实现 地 理 信 息 的 可 视 化 开发 。 只 要 使 用 MapView (com. google. android. 
maps. MapView) 就 可 以 将 Google Ht Al Hz A | Android 应 用 程序 中 。 但 在 使 用 
MapView 进行 开发 前 ,必须 向 Google 申请 一 组 经 过 验证 的 “地 图 密 钥 ”(Map API Key), 
才能 正常 使 用 Google 的 地 图 服务 .“ 地 图 密 钥 ? 是 访问 Google 地 图 数据 的 密 钥 ,无 论 是 
模拟 器 还 是 在 真实 设备 中 需要 使 用 这 个 密 钥 。 

注册 “地 图 密 钥 ”的 第 一 步 是 申请 一 个 Google 账户 ,也 就 是 Gmail 电子 邮箱 ,申请 地 
址 是 https://www. google. com/accounts/Login, 

在 得 到 Google 账户 之 后 ,下 一 步 工 作 是 找到 保存 Debug 证 书 的 keystore 的 保存 位 
置 , 并 获取 证 书 的 MD5 散 列 值 。keystore 是 一 个 密码 保护 的 文件 ,用 来 存储 Android 提 
供 的 用 于 调试 的 证 书 ,获取 MDS 散 列 值 的 主要 目的 是 为 下 一 步 申 请 “地 图 密 钥 ”做 准备 。 
获取 证 书 的 保存 地 址 如 图 9.3 所 示 , 首 先 打开 Eclipse, 通 过 Windows Preferences 打开 
配置 窗 体 ,在 Android > Build 栏 中 的 Default debug keystore 中 可 以 找到 。 


Preferences 


Build 


Build Settings: 


| OSilent 
| ONormal 
| OVerbose 


由 Install/Update Default debug keystore: [C:\Documents and Settings \warner\. android\debug. keystore 


Javea 

E Run/Debug Custom debug keystore: 

由 .Tasks 

由 .Tean 

fg Usage Data Collector 
Validation 


XML, 
Restore Defaults 
e 


9.3 命令 运行 结果 


为 了 获取 Debug 证 书 的 MDS 散 列 值 , 需 要 打开 命令 行 工 具 CMD, 然 后 切换 到 
keystore 的 目录 ,输入 如 下 命令 : 

keytool - list - keystore debug.keystore 

如 果 提 示 无 法 找到 keytool, 可 以 将 二 Java SDK>/bin 的 路 径 添加 到 系统 的 PATH 
变量 中 。 在 提示 输入 keystore 密码 时 ,输入 默认 密码 android,MD5 散 列 值 将 显示 在 最 下 
方 。 如 图 9.4 所 示 , 笔 者 的 MD5 散 列 值 为 68:76:89:C8:A4:24:61:F9:EA:F3:F7:70: 
CC:FD:C8:15。 

申请 “地 图 密 钥 ”的 最 后 一 步 是 打开 申请 页 面 ,输入 MD5 散 列 值 。 申 请 页 面 的 地 址 
是 http://code. google. com/intl/zh-CN/android/add-ons/google-apis/maps-api-signup. 
html, 如 图 9.5 所 示 。 

输入 MDS 散 列 值 后 , 单 击 Generate API Key 按钮 ,将 提示 用 户 输入 Google 账户 , 正 
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C:\WINDOWS\syst em32\cad. exe 口 


tings \warner\. andro id>ke keystore debug.keystore| 


Documents and Settings uc "S.android? 


图 9.4 获取 keystore 的 MDS 散 列 值 


Google Projects for Android: Google APIs 


Download Maps API Key Signup 


Use the form on this page to register with the Google Maps service and obtain a Maps API Key. Registration 
is free, 
Started 
s Google APIs Add: Ý you are developing an Android application that wil display Google Maps data using the API provided in the 
E Maps external library, you must register with the service and get an API Key 


Installing the Add-on A single Maps API key is valid for all applications signed by the corresponding developer certificate. For more 
information about signing, see Signing Your Applications on the Androd Developers ste. 


Home Docs Blog Group 


Before you register, read Obtaining a Maps 
cey 10 understand how your Maps API Key 
sed in your Android application, why it's 
needed, and how to generate an MD5 fingerprint. 
based on your developer certiicate, 


Maps To register for a Key, you also need a Google Account. Once you register, your Key will be associated wih your Google Account 
[Android Maps APIs Terme cf Service "| 
H zl 
ABI Koy Last Updated: October 13, 2008 


ape Ke signup |Thanke for your interest in the Android Maps APIs, Tho Android Maps 
AP! Reference [APIs are a collection of services (including, but not limited to, the 
"con. google. android. aaps.MapView" and “android. locaticn.Geocodsr” 


classes) that allow you to include maps, geocoding, ard other content 


Resources from Google and its content providers in your Android applications 
5 The Android Maps API: explicitly do not include ary driving directions 
Antik SD data or local search data that may be owned or licensed by Google. 
Android Developer's 
Guide » 


1. Your relationship with Google. LI 
1.1. Your use of any of the Android Maps APIs (referred to in this 


E) — nave read and agree wth the terms and conditions (patate version) 


My certífizate's MDS fingerprint: [ 


图 9.5 获取 Map API Key 页 面 


确 输入 Google 账户 后 ,将 产生 申请 “地 图 密 钥 ”的 获取 结果 ,如 图 9.6 所 示 。 


您 的 密 钥 是 : 


ÜnVK8GeO6WVUz 4S2F94z52CIGSSlvlTwnrE4DsiAÀ 


此 密 钥 适用 于 所 有 使 用 以 下 指纹 所 对 应 证 书 进 行 验证 的 应 用 程序 : 


68:76:89:C8:A4:24:61:F9:EA:F3:F7:70:CC:FD:C8:15 


下 面 是 一 个 xml 格式 的 示例 ， 帮 助 您 了 解 地 图 功能 : 


con.google.android.maps.MapView 
android:layout vidth-"fill parent" 
android:layout height-"fill parent" 
android:apikey 


图 9.6 “地 图 密 钥 ” 获 取 结 果 


ÜnVK8GeO6VUz 4S2F94z52CIGSSlvlTwnrE4DsiAÀ" 
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笔者 获取 的 “地 图 密 钥 ”是 0mVK8GeO6WUz4S2F94z52CIGSSIv1ITwnrE4DsiA ,在 以 
后 使 用 到 MapView 的 时 候 都 需要 输入 这 个 密 钥 。 但 需要 注意 的 是 ,这 个 密 钥 读者 并 不 
能 使 用 ,读者 需要 根据 自己 的 Debug 证 书 的 MD5 散 列 值 , 重 新 到 Google 网 站 上 申请 一 
个 用 于 调试 程序 的 “地 图 密 钥 ”。 


922 使 用 Googe 地 图 


在 申请 到 “地 图 密 钥 ”后 ,下 面 考虑 如 何在 Android 系统 中 显示 和 控制 Google 地 图 。 
Map View 的 地 图 显示 控件 ,可 以 设置 不 同 的 显示 模式 ,例如 卫星 模式 、 街 道 模式 或 交通 
模式 。 而 MapController 则 是 MapView 的 控制 器 ,可 以 控制 MapView 的 显示 中 心 和 缩 
放 级 别 等 功能 。 

下 面 的 内 容 以 GoogleMapDemo 为 例 ,说 明 如 何在 Android 系统 中 开发 Google 地 图 
程序 。 这 个 示例 将 在 程序 内 部 设置 一 个 坐标 点 ,然后 在 程序 启动 时 ,使 用 MapView 控件 
在 地 图 上 显示 这 个 坐标 点 的 位 置 。 

因为 普通 的 Android 程序 并 不 包含 支持 Google 地 图 开发 的 扩展 库 , 因 此 应 在 建立 
工程 时 将 com. google. android. maps 的 扩展 库 添 加 到 工程 中 ,这 样 就 可 以 使 用 Google 地 
图 的 所 有 功能 了 。 添 加 com. google. android. maps 扩展 库 的 方式 是 在 创建 工程 时 ,在 
Build Target 项 中 选择 Google APIs, 如 图 9. 7 所 示 。 


Build Target 
Uae LE VEU = Een | 
E] Android 1.1 Android Üpen Source Project L1 2 


Android 1.5 Android Üpen Source Project L5 3 
Google Inc E 


Android + Google APIs 


9.7 引入 Google 地 图 扩展 库 


创建 工程 后 ,修改 /res/layout/main. xml 文件 ,在 布局 中 加 入 一 个 MapView 控件 ， 
并 设置 刚 获取 的 “地 图 密 钥 ”。main. xml 文件 的 完整 代码 如 下 : 


<?xml version- "1.0" encoding= "utf- 8"?» 
< Linearlayout xmlns:android- "http://schemas.android.com/apk/res/android" 
android:orientation- "vertical" 
android:layout width- "fill parent" 
android:layout height= "fill parent"> 
< TextView android:layout width- "fill parent" 
android:layout height- "wrap content" 
android:text- "8 string/hello"/> 


© o A om Dm BF WN PB 


m 
o 


<.cam.google.android.maps .MapView 

n android:id- "@ + id/mapview" 

2 android: layout_width= "fill parent" 
13 android:layout height= "fill parent" 
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14 android:enabled= "true" 
15 android:clickable= "true" 
16 android:apiKey- "OUVK8GeOGWUzAS2F94z 52CIGSSlvlTwnrEADsiA"/» 


17  «/Linearlayout^ 


仅 在 布局 中 添加 Map View 控件 ,还 不 能 够 直接 在 程序 中 调用 这 个 控件 ,还 需要 将 程 
序 本 身 设 置 成 MapActivity (com. google. android. maps. MapActivity) . MapActivity 类 
负责 处 理 显示 Google 地 图 所 需 的 生命 周期 和 后 台 服 务 管理 。 下 面 先 给 出 整个 
GoogleMapDemo. java 文件 的 完整 代码 : 


1 package edu.hrbeu.GoogleMapDemo; 
2 
3 import ccm.google.android.maps .GeoPoint; 
4 import cam.google.android.maps .MapActivity; 
5 import cam.google.android.maps.MapController; 
6 import cam.google.android.maps .MapView; 
y 
8 import android.os.Bundle; 
9 
0 public class GoogleMapDemo extends MapActivity ( 
1 private MapView mapView; 
12 private MapController mapController; 
3 
4 @ Override 
5 public void onCreate (Bundle savedInstanceState) { 
6 Super .onCreate (savedInstanceState) ; 
7 setContentView (R. layout .main) ; 
8 
9 mapView= (MapView) findViewByld (R. id.mapview); 
20 mapController- mapView.getController () ; 
21 
22 Double Ing 126.676530486 * 1E6; 
23 Double lat= 45.7698895661 * 1E6; 
24 GeoPoint point= new GeoPoint (lat.intValue(), lng.intValue()); 
25 
26 mapController.setCenter (point) ; 
2 mapController.setZoan(11) ; 
28 mapController.animateTo (point) ; 
29 
30 mapView.setSatel lite (false); 
31 } 
32 
33 @ Override 
34 protected boolean isRouteDisplayed() { 
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// TODO Auto- generated method stub 
return false; 


ERC 


38 } 


代码 第 20 行 获取 了 MapController; 在 第 26 行 设置 MapView 的 “显示 中 点 ”; 在 第 
27 行 设置 放大 层级 ;在 第 28 行将 MapView 显示 区 域 的 中 心 移动 到 第 26 行 设置 的 “显示 
"a, 代码 第 22 行 和 第 23 行 设 定 的 经 度 为 126.676530486* 1E6、 纬 度 为 
45. 7698895661 * LEG 的 地 理 坐标 点 ;在 代码 第 26 行 ,没有 直接 使 用 这 个 坐标 的 ,而 是 将 
其 转化 为 GeoPoint 再 使 用 ;代码 30 行 是 设 定 MapView 的 地 图 显示 模式 是 否 为 卫星 模 
式 , 设 置 true 则 为 卫星 模式 ,设置 false 则 为 普通 模式 ;代码 第 34 行 isRouteDisplayed() 
方法 ,是 用 来 统计 程序 是 否 在 Google 地 图 中 显示 路 径 信息 ,默认 为 不 显示 。 

运行 前 还 需要 在 AndroidManifest. xml 文件 中 添加 允许 访问 互联 网 的 许可 ,原因 是 
获取 Google 地 图 是 需要 使 用 互联 网 的 。AndroidManifest. xml 文件 的 完整 代码 如 下 : 


1 <?xml versione "1.0" encoding- "utf- 8"?» 
2 «manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 
3 package- "edu.hrbeu.GoogleMapDero" 
4 android:versionCode- "1" 
5 android:versionName- "1.0" 
6 < application android:icon= "@ drawable/icon" android:label- "8 string/app name"? 
7 X activity android:name- ".GoogleMapDemo" 
8 android:label- "0 string/app name" 
9 < intent- filter» 
0 < action android:name- "android.intent.action.MAIN" /> 
< category android:name- "android.intent.category. 
LAUNCHER" /> 
12 < /intent- filter» 
3 < /activity> 
14 < uses- library android:name- "com.google.android.maps">< /uses- library» 
5 < application» 
6 
17 « uses- sdk android:minSdkVersion- "3" /> 
18 < uses- permission android:name= "android.permission.INTERNET"/» 


19  «/manifest^ 


最 后 ,程序 运行 时 需要 连接 互联 网 ,运行 结果 如 图 9.8 所 示 。 
923 使 用 Oeray 


在 目前 的 很 多 基于 地 图 的 应 用 中 ,都 需要 在 地 图 上 显示 信息 或 绘制 图 形 。 通 过 在 
Map View 上 添加 覆盖 层 , 可 以 在 指定 的 位 置 加 添加 注解 .绘制 图 像 或 处 理 进行 鼠标 事件 
等 。Google 地 图 上 可 以 加 入 多 个 覆盖 层 , 所 有 和 蕉 盖 层 均 在 地 图 图 层 之 上 ,每 个 覆盖 层 均 
可 以 对 用 户 的 点 击 事件 做 出 响应 
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GoogleMapDemo 


(b) 卫星 模式 


9.8 GoogleMapDemo 示例 运行 结果 


创建 覆盖 层 继承 Overlay 类 的 子 类 ,并 通过 重 载 draw() 方 法 为 指定 位 置 添加 注解 ， 
ER onTap() 方 法 处 理 用 户 的 点 击 操作 。 下 面 的 代码 是 创建 Overlay 的 最 小 代码 集合 : 


1 
2 
3 
4 
5 
6 
p 
8 
9 


public class TextOverlay extends Overlay ( 


@ Override 


public void draw (Canvas canvas, MapView mapView, boolean shadow) { 


if (shadow = false) { 


} 
else{ 
} 


super .draw (canvas, mapView, shadow); 


@ Override 


public boolean onTap(GeoPoint p, MapView mapView) { 


return false; 


} 


在 代码 第 3 FT AY draw() 方 法 中 ,shadow 变量 是 用 来 区 分 绘制 图 层 的 ,false 表示 在 
覆盖 层 上 进行 绘制 ,而 true 则 表示 在 隐藏 展 上 进行 绘制 。 代 码 的 第 14 行 是 onTap() 方 
法 的 返回 值 ,返回 false 表示 覆盖 层 不 处 理 点 击 事件 ,返回 true 则 表示 已 经 处 理 了 点 击 


事件 。 


在 覆盖 层 绘 制图 形 或 文字 需要 使 用 “画布 "(Canvas) 来 实现 ,绘制 的 位 置 是 屏幕 坐 


2s 位 置 服务 与 地 图 应 用 —207 


这 


标 , 这 就 需要 将 地 图 上 的 物理 坐标 与 屏幕 坐标 进行 转换 。Projection 类 提供 了 物理 坐标 
和 屏幕 坐标 的 转换 功能 ,可 在 经 度 和 纬度 表示 的 GeoPoint 点 和 屏幕 上 Point 点 进行 转 
换 。 其 中 ,toPixels() 方 法 将 物理 坐标 转换 为 屏幕 坐标 ,fromPixels() 方 法 将 屏幕 坐标 转 
换 为 物理 坐标 ,两 个 方法 的 具体 使 用 方法 可 以 参考 下 面 的 代码 : 


1 
2 
3 
4 


Projection projection= mapView.getProjection () 7 


projection.toPixels (geoPoint, point); 
projection.framPixels (point.x, point.y); 


下 面 的 内 容 以 MapOverlayDemo 示例 ,说 明 如 何在 Google 地 图 上 添加 覆盖 层 , 并 在 
预订 的 物理 坐标 上 显示 提示 信息 。MapOverlayDemo 示例 的 运行 结果 如 图 9. 9 所 示 。 

TextOverlay 类 是 MapOverlayDemo 示例 的 覆盖 层 , 主 要 重 载 了 draw() 方 法 ,在 指 
定 的 物理 坐标 上 绘制 了 标记 点 和 提示 文字 。TextOverlay. java 文件 的 核心 代码 如 下 : 


1 public class TextOverlay extends Overlay { 
2 private final int mRadius= 5; 
3 
4 @ Override 
5. public void draw(Canvas canvas, MapView mapView, boolean shadow) ( 
6 Projection projection= mapView.getProjection(); 
7 
8 if (shadow-- false) { 
9 Double 1ng- 126.676530486 * 1E6; 
10 Double lat- 45.7698895661 * 1E6; 
11 GeoPoint geoPoint- new GeoPoint (lat.intValue(), lng.intValue()); 
12 DME 4:22PM 
13 Point point- new Point (); GoogleMapDemo 
14 projection.toPixels (geoPoint, point); Š Lg: Donggang zi 
: RAT 

15 | 

3yushu i Limi PA WT 
16 Rect oval- new RectF (point.x- Ir a Ax) ELE] 

= : i 3 \ d 
mRadius, point.y- mRadius, NEL ` Minzhu 
uo N 民主 乡 
point.x* 
mRadius, point.y+mRadius) ; 
17 2 
18 Paint paint- new Paint (); ` pier 3 Kaohezhai 
Rae 

19 paint.setARGB (250, 250, 0, 0); 
20 paint.setAntiAlias (true); 
21 paint.setFakeBoldText (true) ; "| EB | Ew 

An e 
B oneal Js ingfangzhen 
23 canvas.drawOval(oval, paint); d Vaa 
24 canvas.drawlext ("bj iL dn, point.x+ 2 is 


* tRxtius, point.y, paint); 图 9.9 MapOverlayDemo 运行 结果 
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人 .sx 


Super.draw (canvas, mapView, shadow); 


@ Override 
public boolean onTap (GeoPoint p, MapView mapView) { 
return false; 


} 


代码 第 2 行 定 义 了 绘制 半径 变量 mRadius, 供 定义 绘制 范围 使 用 ;代码 第 14 行使 用 
Projection 完成 了 从 物理 坐标 到 屏幕 坐标 的 转换 ;第 19 行 设 置 了 绘制 颜色 ;第 20 行 开启 
了 平滑 设置 ,防止 文字 出 现 锯齿 :代码 第 23 行 绘制 了 圆 形 的 标记 点 ,标记 点 的 大 小 以 代 
码 第 16 行 设 定 的 oval 为 准 ;代码 第 24 行 绘制 了 提示 文字 ,第 2 个 和 第 3 个 参数 是 绘制 
屏幕 的 x 坐 标 和 y 坐标 。 

建立 了 覆盖 层 后 ,还 需要 把 覆盖 层 添加 到 MapView 上 。MapOverlayDemo. java 的 


核 心 代 fi 如 T: 
1 public class MapOverlayDemo extends MapActivity ( 
2 private MapView mapView; 
3 private MapController mapController; 
4 private TextOverlay textOverlay; 
5 
6 @ Override 
7 public void onCreate (Bundle savedInstanceState) { 
8 super .onCreate (savedInstanceState) ; 
9 setContentView (R. layout .main) ; 
10 
11 mapView- (MapView) findViewByld (R.id.mapview) ; 
12 mapController- mapView.getController () ; 
13 
14 Double 1ng-126.676530486 * 1E6; 
15 Double lat= 45.7698895661 * 1E6; 
16 GeoPoint point- new GeoPoint (lat.intValue(), lng.intValue()); 
17 
18 mapController.setCenter (point) ; 
19 mapController.setZoan(11) ; 
20 mapController.animateTo (point) ; 
21 
22 textOverlay- new TextOverlay () 7 
23 List< Overlay» overlays- mapView.getOverlays () 7 
24 overlays.add (textOverlay) ; 
25 } 
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@ Override 

28 protected boolean isRouteDisplayed() { 
29 retum false; 

30 } 

3 ) 


代码 第 22 行 实例 化 了 TextOverlay 对 象 ;在 第 23 行 通过 getOverlays() 方 法 ,获取 
MapView 已 有 的 覆盖 层 ;在 第 24 行使 用 add O Jr i T£. TextOverlay 对 象 添加 到 
MapView 中 。 


SI zm 
l. 讨论 位 置 服务 和 地 图 应 用 的 发 展 前 景 。 


2. 编程 实现 轨迹 追踪 软件 。 每 间隔 60 秒 , 同 时 距离 移动 大 于 1 米 的 情况 下 ,记录 一 
次 位 置信 息 ,在 Google 地 图 上 绘制 600 秒 的 行动 轨迹 。 


& 10 3€ done 1. 


Android NDK 开发 


Android NDK 的 出 现 使 Android 平台 能 够 使 用 C/C++ 等 非 托 管 代码 开发 应 用 程 
序 , 对 Android 平 台 的 普及 具有 深远 的 意义 。 通 过 本 章 的 学 习 可 以 让 读者 初步 了 解 
Android NDK 的 开发 方法 。 

本 章 学 习 目 标 : 

* 了 解 Android NDK 的 用 途 

。 48 Android NDK 编译 环境 的 安装 与 配置 方法 

。 掌握 Android NDK 的 开发 方法 


101 NKE 介 


Android NDK(Android Native Development Kit) 是 一 系列 的 开发 工具 ,允许 程序 开 
发 人 员 在 Android 应 用 程序 中 嵌入 C/C++ 语言 编写 的 非 托 管 代码 。 一 般 情况 下 ， 
Android 应 用 程序 主要 使 用 Java 语言 进行 开发 ,编译 后 产生 的 托管 代码 在 Dalvik 虚拟 机 
上 运行 。 但 在 一 些 需 要 较 高 执行 效率 的 地 方 ,程序 开 发 人 员 希 望 能 够 使 用 非 托 管 代码 ， 
以 提高 Android 应 用 程序 的 核心 部 分 的 运行 速度 。 不 仅 如 此 ,程序 开发 人 员 还 希望 能 够 
直接 使 用 完善 成熟 的 C/C++ 源 代码 ,以 提高 Android 应 用 程序 的 开发 速度 。Android 
NDK 的 出 现 , 不 仅 解决 了 核心 模块 使 用 托管 语言 开发 执行 效率 低下 的 问题 ,还 允许 程序 
开发 人 员 直 接 使 用 C/C++ 源 代码 , 极 大 地 提高 了 Android 应 用 程序 开发 的 灵活 性 。 

当然 ,在 使 用 Android NDK 过 程 中 不 能 仅 看 到 它 所 带 来 的 好 处 ,程序 开发 人 员 必 须 
清楚 认识 到 Android NDK 的 不 足 。 首 先 , 虽 然 使 用 C/C++ 语言 开发 Android 程序 会 提 
高 运行 效率 ,但 同时 也 会 增加 程序 的 复杂 性 ,增加 了 程序 调试 的 难度 ,因此 程序 开发 人 员 
需要 在 运行 效率 和 复杂 性 之 间 做 个 选择 。 其 次 ,程序 开发 人 员 需 要 认识 到 CPU 运算 量 
大 和 内 存 消耗 较 少 的 部 分 (例如 信号 处 理 或 物理 仿真 ) 使 用 非 托 管 代码 运行 效率 最 高 , 因 
此 并 不 是 所 有 的 核心 部 分 都 适合 使 用 C/C++ 语言 编写 。 

目前 Android NDK 的 版 本 是 1. 5, 集 成 了 交叉 编译 器 ,支持 ARMv5TE 处 理 器 指令 
48 INI 接口 和 一 些 稳定 的 库 文件 ,但 仅 支持 Android SDK 1.5 版 本 ,因此 1.0 和 1.1 版 
本 的 应 用 程序 不 能 够 使 用 Android NDK, Android NDK 提供 一 系列 的 说 明文 档 、 示 例 
代码 和 开发 工具 ,指导 程序 开发 人 员 使 用 C/C++ 语言 进行 库 文件 开发 ,并 提供 便捷 工具 
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将 库 文件 打包 到 apk 文件 中 。 


102 NK 编译 环境 


Android NDK 编译 环境 支持 Windows XP, Linux 和 Mac OS, 本 书 仅 介 绍 Windows 
系统 的 编译 环境 配置 方法 。 

第 一 步 , 在 Google 的 官方 网 站 下 载 Android NDK 的 安装 包 , 下 载 地 址 是 http:// 
developer. android. com/sdk/ndk/1. 5_rl/index. html, 打 开 下 载 页 面 后 选择 的 下 载 文件 
为 android-ndk-1. 5 rl-windows. zip, 如 图 10. 1 所 示 。 将 下 载 的 ZIP 文件 解压 缩 到 用 户 
的 Android 开发 目录 中 ,作者 将 Android NDK fit E 8] E:\ Android 目录 中 ,ZIP 文件 中 包 
含 一 层 目 录 , 因 此 Android NDK 的 最 终 路 径 为 E:\Android\android-ndk-1. 5. rl. 

Download Android 1.5 NDK, Release 1 


June 2009 


The Android NDK is a companion tool to the Android SDK that lets Android application developers build performance-critical 
portions of their apps in native code. It is designed for use only in conjunction with the Android SDK, so if you have not 
already installed the Android 1.5 SDK, please do so before downloading the NDK. Also, please read What is the Android 
NDK? to get an understanding of what the NDK offers and whether it will be useful to you 


Select the download package that is appropriate for your development computer. 


Windows android-ndk-15 rl-windows.zip 22500667 bytes e5c53915903d8b813e2ea422e2e2717 
Mac OS X (intel) android-ndk-1.5 rl-darwin-x86 zip 17215303 bytes 193110e18279834c98924fd87380b5b8 


Linux 32/64-bit (x86) android-ndk-1.5 ri-linux-xX86.zip ^ 16025885 bytes 80a4e14704ca84c21bfI824cb25fbdBb 


10.1 Android NDK 下 载 页 面 


第 二 步 是 下 载 并 安装 Cygwin. Hifi. Android NDK 还 不 支持 在 Windows 系统 下 直 
接 进 行 交叉 编译 ,因此 需要 在 Windows 系统 下 安装 一 个 Linux 的 模拟 器 环境 Cygwin, sé 
成 C/C++ 代 码 的 交叉 编译 工作 。Android NDK 要 求 GNU Make 的 版 本 高 于 或 等 于 
3. 18 ,之 前 的 版 本 并 没有 经 过 测试 ,因此 需要 安装 较 新 版 本 的 Cygwin。Cygwin 的 最 新 
版 本 可 以 到 官方 网 站 http://www. cygwin. com 下 载 , 也 可 以 到 中 文 的 映像 网 站 http:// 
www. cygwin. cn 下载 。 在 Cygwin 的 安装 过 程 中 ,需要 将 Devel FAY gcc 和 make 的 相 
关 选 项 选 上 ,如 图 10. 2 所 示 ,否则 Cygwin 将 无 法 编译 C/C++ 代码 文件 。 

第 三 步 是 配置 Cygwin 的 NDK 开发 环境 。 在 默认 情况 下 ,Cygwin 安装 在 C 盘 的 根 
目录 下 ,修改 C:\cygwin\home\username, bash profile 文件 ,username 会 根据 用 户 使 
用 的 用 户 名 称 而 变化 。 在 . bash profile 文件 的 结尾 处 添加 如 下 代码 : 

ANDROID NIK ROOT- /cygdrive/e/android/android- ndk- 1.5 r1 

export ANDROID NDK ROOT 

上 面 的 代码 说 明了 Android NDK 所 在 的 目录 ,目录 是 e 盘 android/android-ndk-1. 5 
_rl1。 如 果 用 户 的 Android NDK 安装 在 C 盘 的 TestAndroid/android-ndk-1. 5_r1 中 , 则 
上 面 的 代码 则 应 该 为 : 
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ANDROID NK ROOT= /cygdrive/c/TestAndroid/android- ndk- 1.5 r1 


export ANDROID NDK ROOT 


- Cygwin Setup — Select Packages 


Select Packages 
Select packages to install 


Current New 


Okeep O Prev 


. | Size 


Our 


3. 4. 4-999 3.4.4-3 
全 Skip 

3. 4. 4-999 Keep 

3. 4. 4-999 43.4.43 
全 Skip 
Skip 
Skip 
Skip 


Hide obsolete packages 


10.2 


最 后 一 步 是 测试 开发 环境 是 否 可 


1k 

6, 708k 
3, 630k 
, 958k 

, ST6k 

, 181k 

, 428k 
11, 731k 


gcc: C compiler upgrade helper 


£cc-ada: Ada compiler 


gec-core: C compiler 


gcc-gHt: Ct+ compiler 


Secci! Fortran 


compiler 


gcc-gde: D compiler 


gcc-gpc: GNU Pascal compiler 


gcc-java: Java compiler 


Cygwin 安装 选项 


以 正常 工 


YE. 首先 


<+-# ®)[F-FW >] 取消 


启动 Cygwin, 然 后 切换 到 


Android NDK>/build 目录 中 ,运行 host-setup. sh 文件 。 如 果 出 现 图 10. 3 所 示 的 运 


行 结果 ,说明 Android NDK 的 开发 环境 已 经 可 以 正 


rner&jorini 


? compiler check ok (gcc) 


: linker check ok gcc) 
: C++ compiler check ok 
: out/host/config.mk 


g++) 


ffoolchain : Checking for arm-eabi-4.2.1 prebuilt binaries 


st setup complete. Please read docs/OUERUIEU.TXT if you don 


jorini /cygdrive/e/Android 


android-ndk-i 


5 ri/build 


图 10.3 运行 host-setup. sh 文件 


工作 了 。 


^t know what to do.| 


到 此 为 止 ,Android NDK 的 编译 环境 已 经 安装 配置 完毕 ,下 面 介 绍 Android NDK 的 
目录 结构 ,以 及 各 个 目录 或 文件 的 作用 。 在 android-ndk-1. 5 


和 2 个 文件 ,结构 如 下 所 示 : 


(+ )apps 
(+ )hello- jni 
(-)tow- Libs 
(+ )build 
(+ )docs 
(+ )out 


(-) .gitignore 


rb 目录 中 ,包含 5 个 子 目录 
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(+ ) sources 
(+ )sanples 
(+ )hello- jni 
(+ )tow- libs 
(- )Android.mk 
(- )GNUmakefile 
(~ )README.TXT 
其 中 ,apps 目录 是 Android 工程 的 保存 目录 , 子 目 录 hello-jni 和 tow-libs 是 NDK A 
带 的 两 个 示例 目录 。build 目录 保存 了 交叉 编译 工具 、 编 译 脚本 和 配置 文件 。docs 目录 
是 帮助 文档 的 保存 目录 ,帮助 文档 的 名 称 和 用 途 参 考 表 10. 1。out 目录 是 交叉 编译 的 输 
出 目录 ,保存 输出 的 so 文件 。sources 目录 是 C/C ++ 源 代码 文件 的 保存 目录 ,其 下 的 
hello-jni 和 tow-libs 子 目录 ,分 别 保 存 了 NDK 自 带 示例 所 需要 的 C/C ++ 源 代码 文件 。 
GNUmakfile 文件 和 README, TXT 文件 分 别 是 make 工具 的 配置 文件 和 NDK 的 说 明 
文件 。 


表 10.1 docs 目录 中 的 帮助 文件 说 明 


文 件 名 说 明 
INSTALL. TXT NDK 的 安装 与 配置 说 明文 档 
OVERVIEW. TXT NDK 的 用 途 和 使 用 范围 的 说 明文 档 
Android. mk 文件 的 说 明文 档 ,Android. mk 文件 定义 了 需要 编译 


A ID-MK. i 
NDROID-MK. TXT 的 C/C++ 源 代码 


Application. mk 文件 的 说 明文 档 , Application. mk 文件 定义 了 
Android 工程 需要 调用 的 C/C++ 源 代码 


APPLICATION-MK. TXT 


HOWTO. TXT 关于 NDK 开发 的 一 般 性 信息 
SYSTEM-ISSUES. TXT 使 用 NDK 开发 时 所 需要 注意 的 问题 
STABLE-APIS. TXT NDK 头 文件 所 支持 的 稳定 的 API 类 表 


Android NDK 自 带 两 个 示例 hello-jni 和 tow-libs。hello-jni 是 一 个 非常 简单 的 例 
子 , 非 托管 代 码 实现 了 一 个 可 以 返回 字符 串 的 共享 库 ,Android 工程 调用 这 个 共享 库 获取 
字符 串 ,然后 显示 在 用 户 界面 上 。tow-libs 是 稍微 复杂 一 些 的 例子 ,使 用 非 托 管 代 码 实 现 
了 一 个 数学 运算 的 共享 库 ,Android 工程 动态 加 载 这 个 共享 库 , 并 调用 其 中 的 函数 ,函数 
功能 是 通过 使 用 静态 库 实 现 的 。 


103 NDK 开 发 示例 
在 进行 NDK 开发 时 ,一 般 需 要 同时 建立 Android 工程 和 C/C++ 工程 ,然后 使 用 


NDK 编译 C/C++ 工程 ,形成 可 以 被 调用 的 共享 库 ,最 后 共享 库 文件 会 被 拷贝 到 Android 
工程 中 ,并 被 直接 打包 到 apk 文件 中 。 
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人 six 


后 面 的 内 容 将 AndroidNdkDemo 示例 说 明 如 何 进 行 Android NDK 开发 。 
AndroidNdkDemo 是 一 个 进行 加 法 运算 的 示例 ,程序 会 
随机 产生 两 个 整数 ,然后 调用 C 语言 开发 的 共享 库 对 这 — AndroiNdkDemo LLL LLL 
两 个 整数 进行 加 法 运算 ,最 后 将 运算 结果 显示 在 用 户 界 
面 上 。AndroidNdkDemo 示例 的 界面 如 图 10.4 所 示 。 

进行 Android NDK 开发 一 般 要 经 过 如 下 的 步骤 : 

(1) 建立 Application. mk 文件 。 

(2) 建立 Android 工程 。 

(3) 建立 Android. mk 文件 。 

(4) 建立 C 源 代码 文件 。 

(5) 编译 共享 库 模 块 。 

(6) 运行 Android 程序 。 

下 面 的 内 容 将 详细 介绍 Android NDK 开发 的 每 一 个 步骤 。 


图 10.4  AndroidNdkDemo 示例 界面 


1, 建立 Application. mk 文件 


进行 Android NDK 开发 前 , 首先 需要 在 apps 目录 中 建立 应 用 程序 目录 ， 
AndroidNdkDemo 示例 的 应 用 程序 目录 为 ndk-demo, 然 后 在 ndk-demo 目录 中 建立 一 
空 目 录 project, 这 个 目录 以 后 会 用 来 存放 Android 工程 。 最 后 在 ndk-demo 目录 中 建立 
一 个 名 为 Application. mk 的 文件 , 用 来 描述 Android 工程 将 调用 的 共享 库 。 
AndroidNdkDemo 示例 的 目录 结构 如 下 所 示 : 


(+ )apps 
(+ ) ndk- demo 
(+ )project. 
(- )Application.mk 
在 进行 NDK 开发 时 ,在 应 用 程序 目录 中 一 定 要 有 Application. mk 文件 ,用 来 声明 
Android 工程 需要 调用 的 非 托 管 模块 (如 静态 库 或 共享 库 )。AndroidNdkDemo 示例 的 
Application. mk 的 代码 如 下 : 
1 APP PROJECT PATH :=$ (call my- dir) /project 
2 APP_MODULES := add- module 
在 上 面 的 代码 中 ,第 1 行 的 变量 APP. PROJECT. PATH 表示 Android 工程 所 在 的 
目录 ,在 生产 共享 库 文件 后 ,APK 生产 工具 将 自动 将 共享 库 文 件 拷贝 到 过 app 之 \libs\ 
armeabi 目录 中 ,本 示例 将 共享 库 文件 拷贝 到 apps\ndk-demo\ project\ libs\armeabi 目录 
中 。 第 2 行 代码 中 的 变量 APP_MODULES 表示 Android 工程 需要 调用 的 非 托 管 模块 ， 
如 果 存 在 多 个 非 托 管 模块 ,使 用 空格 进行 分 隔 。 本 示例 调用 的 非 托管 模块 为 add- 
module, 对 应 在 后 面 涉及 的 Android. mk X fF. Application. mk 的 所 有 变量 说 明 可 以 参 
考 表 10.2, 
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表 10.2 Application. mk 的 变量 说 明 


强制 使 用 说 B 
APP_PROJECT_PATH 是 Android 工程 所 在 的 目录 
APP_MODULES 是 Android 工程 需要 调用 的 非 托管 模块 


APP_OPTIM 


指定 优化 等 级 ,包含 两 个 等 级 debug 和 release, release 
是 默认 设置 。debug 生产 非 优化 代码 ,更 加 易于 调试 


APP_CFLAGS 


编译 C 代码 时 所 传递 的 编译 器 标志 


APP_CXXFLAGS 


编译 C++ 代码 时 所 传递 的 编译 器 标志 


APP_CPPFLAGS 


KEIER 


编译 C/C++ 代码 时 所 传递 的 编译 器 标志 


2. 建立 Android 工程 


下 面 来 说 明 如 何在 project 目录 中 建立 Android 工程 。 在 建立 Android 工程 时 ,需要 
取消 复 选 框 Use default location, ,并 指定 预先 建立 的 project 文件 夹 作为 工程 文件 夹 , 如 


图 10.5 所 示 。 


Project name: [Androi dNdkDeno 


Contents 
@Create new project in workspace 
O Create project from existing source 


Location: |E: \Android\androi d-ndk-1.5_r1\epps\ndk-deno\project |[ Browse... 


图 10.5 建立 AndroidNdkDemo 工程 


在 建立 AndroidNdkDemo 工程 后 ,修改 main. xml 文件 ,添加 一 个 id 为 display 的 
TextView 和 一 个 id 为 add_btn 的 Button 按钮 。 程 序 中 的 生产 随机 数 和 调用 的 代码 在 
AndroidNdkDemo. java 文件 中 ,下 面 是 AndroidNdkDemo. java 文件 的 核心 代码 : 


1 
e 
3 
4 
5 
6 
7 
8 
9 


public class AndroidNdkDemo extends Activity ( 
@ Override 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedInstanceState) ; 
setContentView (R. layout .main) ; 
final TextView displayLable- (TextView) findViewByld (R.id.display) ; 
Button btn= (Button) findViewById (R.id.add btn); 
btn.setOnClickListener (new View.OnClickListener () { 
@ Override 
public void onClick (View v) { 
double randamDouble- Math. random () ; 
long x= Math. round (randomDoublex 100); 
randmDouble= Math. random () ; 
long y= Math. round (randomDoublex 100); 
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Dosis nan 


16 //System. loadLibrary ("add- module") ; 
17 log z-adi(x, y); 

18 String msg- xt "+ "+ yt "—- "tz; 
19 displayLable.setText (msg) ; 

20 } 

2 D 

22 } 

23 //public native long add(long x, long y); 
24 

25 public long add(long x, long y){ 

26 return xt y; 

27 ) 

28 } 


上 面 的 代码 有 一 个 NDK 开发 的 小 技巧 ,在 开发 C/C++ 的 共享 库 前 ,可 以 使 用 具有 
相同 和 相近 功能 的 Java 函数 进行 蔡 代 。 在 代码 第 17 行 本 应 该 调用 共享 库 的 add O PR 
数 , 但 为 了 便于 开发 和 调试 ,在 代码 第 25 行 到 第 27 行 ,使 用 Java 代码 开发 了 一 个 功能 相 
同 的 add0O) 函 数 , 这 样 即使 在 没有 完成 C/C++ 的 共享 库 开发 前 ,也 可 以 对 这 个 Android T. 
程 进 行 界面 部 分 的 调试 。 第 16 行 和 第 23 行 注释 掉 的 代码 ,就 是 在 C/C++ 的 共享 库 开发 
完毕 后 需要 使 用 的 代码 ,其 中 第 16 行 是 动态 加 载 共 享 库 的 代码 ,加 载 的 共享 库 名 称 为 
add-module; 第 23 行 用 来 声明 共享 库 的 函数 ,使 用 C/C++ 开发 的 共享 库 必 须 有 同名 的 孙 
数 。 在 共享 库 开发 完毕 后 ,取消 第 16 行 和 第 23 行 代码 的 注释 ,并 注释 掉 第 25 行 到 第 27 
行 代码 ,这样 程 序 就 可 以 正常 调用 共享 库 内 的 函数 进行 加 法 运算 了 。 


3. 建立 Android. mk 文件 


建立 C/C ++ 源 代码 文件 前 , 首先 需要 在 sources 目录 中 建立 模块 目录 ， 
AndroidNdkDemo 示例 的 模块 目录 为 add-module, 这 个 模块 目录 的 名 称 与 Application. 
mk 文件 中 声明 的 模块 名 称 相 同 。add-module 目录 中 包含 两 个 文件 , Android. mk 和 
add-module. c, 目 录 结 构 如 下 所 示 : 
(+ ) sources 
(+ )add- module 
(- )Android.mk 
(- )add- module.c 
Android. mk 是 为 NKD 编译 系统 准备 的 脚本 文件 ,用 来 描述 模块 需要 编译 C/C ++ 
文件 的 信息 。 一 般 情 况 下 ,NKD 编译 系统 会 搜寻 $ NDK/sources/ * /目录 中 的 所 有 
Android. mk 文件 ,但 如 果 程序 开发 人 员 将 Android. mk 文件 放置 在 下 一 级 目录 中 , 则 需 
要 在 上 一 级 目录 中 的 Android. mk 文件 添加 如 下 代码 : 


include $ (call all- subdir- makefiles) 


下 面 来 分 析 AndroidNdkDemo 示例 的 add-module 模块 的 Android. mk 文件 。 
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Android. mk 文件 的 代码 如 下 : 


IOCAL PATH:=$ (call my- dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := add- module 
LOCAL SRC FIIES :=add- module.c 


c A o Dm e ou N ro 


include $ (BUILD_SHARED LIBRARY) 


每 个 Android. mk 文件 都 必须 以 第 1 行 代码 开始 ,变量 LOCAL PATH 用 来 定义 需 
要 编译 的 C/C++ 源 代码 的 位 置 ,my-dir 由 NKD 编译 系统 提供 ,表示 当前 目录 的 位 置 。 
代码 第 3 行 的 include $ (CLEAR_VARS) 表 示 清 空 所 有 以 LOCAL 开始 的 变量 ,例如 
LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES 等 ,但 第 1 
行 定 义 的 LOCAL_PATH 不 在 清空 的 范围 内 。 因 为 所 有 的 脚本 都 将 粘贴 到 同一 个 GNU 
Make 的 执行 上 下 文中 ,而 且 所 有 变量 都 是 全 局 变量 ,因此 必须 在 每 次 使 用 前 清空 所 有 以 
前 用 过 的 变量 。 

第 5 行 代码 变量 LOCAL MODULE 用 来 声明 模块 名 称 ,模块 名 称 必须 唯一 ,而 且 中 
间 不 能 存在 空格 。NKD 编译 系统 将 会 在 模块 名 称 前 自动 添加 lib 前缀 ,然后 生产 so X 
件 。 这 里 的 模块 名 称 为 add-module, 生 产 的 共享 库 文件 名 为 libadd-module. so。 但 需要 
注意 的 是 ,如 果 程 序 开发 人 员 使 用 具有 lib 前 级 的 模块 名 称 , NKD 编译 系统 将 不 再 添加 
前 级 ,例如 模块 名 称 为 libsub, 生 产 的 共享 库 文件 名 为 libsub. so. 

第 6 行 代 码 中 的 变量 LOCAL_SRC_FILES 表示 编译 模块 所 需要 使 用 的 C/C++ 文件 
列表 ,但 不 需要 给 出 头 文件 的 列表 ,因为 NKD 编译 系统 会 自动 计算 依赖 关系 。add- 
module 模块 仅 需要 一 个 C 文件 ,文件 名 为 add-module. c。 上 默认 情况 下 ,结尾 名 为 .c 的 文 
件 是 C 语言 源 文件 ,结尾 名 为 . cpp 的 文件 是 C++ 语言 源 文件 。 

第 8 行 代码 include $ (BUILD_SHARED_LIBRARY) 表 示 NKD 编译 系统 构建 共 
享 库 ,如 果 变 量 BUILD. SHARED. LIBRARY 更 改 为 BUILD_STATIC_LIBRARY, 则 
表示 需要 NKD 编译 系统 构建 静态 库 。 


4. 建立 C 源 代码 文件 


根据 Android. mk 文件 的 声明 ,add-module 模块 仅 包含 一 个 C 源 代码 文件 add- 
module. c, add-module. c 文件 的 作用 是 实现 两 个 整数 加 法 运算 功能 ,全 部 代码 如 下 : 


1 # include <jni.h> 

2 

3 jong Java edu hrbeu AndroidwNdkDemo AndroidNdkDemo ada( JNIFnv* ew, 
jobject this, jlong x, jlong y) 

4 { 


a 


return xt y; 
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代码 第 1 行 引 入 的 是 JNI(Java Native Interface) 的 头 文件 。 第 3 行 代码 是 函数 名 
PK ,jlong 表示 Java 长 型 整数 ,Java_edu_hrbeu_AndroidNdkDemo_AndroidNdkDemo . 
add 的 构成 为 Java — & 4 Fk << KS 所 函 数 二 ,其 中 志 函 数 二 的 名 称 和 参数 要 与 
AndroidNdkDemo. java 文件 定义 的 函数 一 致 , AndroidNdkDemo. java 文件 定义 的 函数 
为 public native long add(long x. long y)。 第 5 行 代 码 用 来 返回 加 法 运算 结果 。 


5. 编译 共享 库 模 块 


到 目前 为 止 ,编译 前 的 准备 工作 基本 就 绪 , 程 序 开发 人 员 可 以 直接 编译 共享 库 模 块 
了 。 首 先 启 动 cygwin, 然 后 切换 到 Androd NDK 的 主 目录 下 ,输入 如 下 的 编译 命令 ， 


make APP- ndk- demo 


其 中 ,ndk-demo 是 apps 目录 下 的 应 用 程序 目录 名 称 。 在 指定 应 用 程序 (目录 ) 名 称 后 ， 
NKD 编译 系统 会 首先 找到 目录 中 的 Application. mk 文件 ,根据 Application. mk 文件 的 
信息 ,确定 该 Android 共享 需要 使 用 add-module 模块 ;然后 在 sources 目录 中 搜索 所 有 
Android. mk 文件 ,在 找到 与 add-module 模块 匹配 的 Android. mk 文件 后 ,根据 
Android. mk 文件 提供 的 信息 编译 指定 的 C/C++ 源 代码 文件 ,形成 共享 库 文件 ;最 后 将 生 

的 共享 库 文件 拷贝 到 Android 工程 的 指定 目录 中 。 

但 目前 Android NDK 1.5 版 本 存在 一 个 小 错误 ,如 果 用 户 直 接 运 行 make APP 
ndk-demo 命令 编译 程序 ,NDK 编译 系统 将 提示 out/host/config. mk 文件 不 存在 ,让 用 
户 重新 运行 build/host-setup. sh 脚本 ,如 图 10.6 所 示 。 


BE 


图 10.6 Android NDK 1. 5 版 本 的 错误 提示 


解决 这 一 问题 的 方法 非常 简单 ,只 需 将 二 Android NDK>/build/out/host 文件 夹 和 
其 中 的 config. mk XH N A< Android NDK>/out 目录 中 即 可 。 

编译 成 功 的 提示 信息 如 图 10.7 所 示 , 提 示 信 息 包括 编译 add-module 模块 所 使 用 到 
的 文件 ,生产 so 文件 的 文件 名 和 so 文件 的 安装 位 置 。 为 了 确认 是 否 成 功 编译 了 模块 ,用 
户 可 以 打开 apps/ndk-demo/ project/libs/armeabi 目录 ,如 果 目 录 中 存在 libadd-module. 
so 文件 , 则 表示 编译 成 功 。 


行 和 第 23 行 的 注释 取消 ,并 注释 掉 第 25 行 到 第 27 行 代 码 。 
EJ Em 


1. 简 述 Android NDK 开发 的 优势 和 不 足 。 

2. 说 明 Android NDK 应 用 程序 开发 的 一 般 步 又 。 
的 函数 功能 。 

4. 使 用 NDK 能 提高 复杂 函数 的 运算 速度 ,但 程序 运行 效率 的 提升 并 不 容易 度量 。 
分 别 使 用 C/C++ 和 Java 语言 设计 一 个 具有 复杂 运算 的 函数 ,通过 对 比 函 数 的 调用 和 返 
回 时 间 ,分 析 NDK 对 提高 程序 运行 效率 的 能 力 。 


3. 参考 NDK 的 tow-libs 示例 ,使 用 静态 库 实现 AndroidNdkDemo 示例 中 加 法 运算 
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本 章 将 以 “天 气 预报 短信 服务 软件 ”作为 示例 ,综合 运用 以 往 章 节 所 学 习 的 知识 和 技 
巧 ,从 需求 分 析 、 界 面 设计 、 模 块 设计 和 程序 开发 等 几 个 方面 ,详细 介绍 Android 应 用 程 
序 的 设计 思路 与 开发 方法 。 通 过 本 章 的 学 习 可 以 让 读者 初步 具备 Android 应 用 程序 的 
设计 和 开发 能 力 。 

本 章 学 习 目 标 : 

* 了 解 Android 应 用 程序 的 设计 和 开发 过 程 

。 掌握 使 用 多 种 组 件 进行 Android 程序 开发 的 方法 
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通过 前 面 章 节 的 学 习 , 读 者 应 该 已 经 掌握 了 较 多 的 Android 应 用 程序 的 开发 知识 和 
方法 ,但 如 何 能 够 综合 地 运用 这 些 知 识 和 方法 ,解决 实际 开发 中 所 遇 到 的 问题 ,还 是 一 个 
需要 继续 学 习 和 欣 讨 的 问题 。 设 计 本 章 的 初衷 就 是 希望 读者 能 够 根据 实际 项 目的 需求 ， 
准确 地 分 析出 Android 应 用 程序 开发 可 能 涉及 到 的 知识 点 ,并 学 会 如 何 通 过 分 析 软 件 的 
需求 ,快速 地 设计 出 应 用 程序 的 用 户 界 面 和 模块 结构 ,并 最 终 完成 应 用 程序 的 开发 和 

本 章 提供 的 “天 气 预报 短信 服务 软件 ?是 一 个 略微 复杂 的 示例 。 在 这 个 综合 示例 中 ， 
有 一 个 显示 天 气 情 况 的 用 户 界面 ,可 以 通过 图 片 和 文字 显示 当前 和 未 来 几 天 的 天 气 状 
况 ,包括 温度 、 湿 度 、 风 向 和 雨 雪 情 况 等 。 这 些 天 气 数据 是 通过 后 台 服 务 获取 的 ,这 个 后 
台 服 务 可 以 按照 一 定时 间 间 隔 , 从 Google 上 获取 天 气 预报 信息 ,并 将 天 气 信息 保存 在 后 
台 服 务 中 。 示 例 还 需要 提供 基于 SMS 短信 的 天 气 数据 服务 ,其 他 手机 用 户 可 以 向 本 示 
例 所 在 的 手机 上 发 送 SMS 短信 ,并 在 短信 中 包含 用 户 指定 的 关键 字 , 则 可 以 将 保存 在 后 
台 服 务 中 的 天 气 情况 , 青 通过 SMS 短信 回复 给 用 户 。 最 后 ,每 个 被 发 送 的 SMS 短信 都 
要 被 记录 下 来 ,用 户 可 以 浏览 或 删除 这 些 回 复 信 息 。 

从 上 面 的 描述 中 可 以 基本 了 解 软件 的 功能 需求 ,但 为 了 将 需求 分 析 变 得 简单 明了 ， 
首先 找 出 用 户 界 面 上 需要 显示 的 内 容 。 上 面 的 功能 描述 中 有 显示 天 气 情况 的 界面 和 浏 
览 回复 信息 的 界面 , 除 此 以 外 ,一 般 情况 下 应 用 软件 还 包含 设置 配置 信息 的 用 户 界 面 。 
因此 ,本 示例 应 该 包含 三 个 主要 的 用 户 界面 : 
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(1) 显示 天 气 预 报 的 用 户 界面 。 

(2) 显示 已 发 送 SMS 短信 的 用 户 界面 。 

浏览 和 设置 配置 信息 的 用 户 界 面 。 

一 步 从 用 户 界 面 出 发 ,分 析 隐 藏 在 用 户 界 面 后 面 的 内 部 功能 ,这 些 功能 是 用 户 界 

DE Bi a e 在 “显示 天 气 预报 的 用 户 界面 "中 ,如 果 需 要 在 界面 上 显示 天 气 
信息 , 则 必须 首先 从 互联 网 获取 天 气 信 息 数据 ,并 将 数据 提供 给 自动 回复 的 SMS 短信 。 
而 在 “显示 已 发 送 SMS 短信 的 用 户 界面 * 中 ,为 了 实现 自动 回复 具有 关键 字 的 SMS 短 
信 , 则 需要 根据 关键 字 监 视 所 有 接收 到 的 短信 ,并 且 支 持 发 送 SMS 短信 功能 ,最 后 为 能 
够 浏览 回复 的 短信 信息 ,还 需要 将 SMS 数据 保存 到 数据 库 中 。 在 “浏览 和 设置 配置 信息 
的 用 户 界面 >” 中, 则 应 该 实现 基本 的 配置 信息 保存 和 读 取 功能 ,并 能 够 恢复 系统 的 默认 设 
置 。 根 据 用 户 的 功能 需求 ,用 户 界面 和 内 部 功能 的 关系 如 下 所 示 : 

(1) 显示 天 气 预报 的 用 户 界面 

获取 Google 的 天 气 数据 。 

(2) 显示 SMS 短信 的 用 户 界 面 

(D 根据 关键 字 监 视 SMS Afri. 

O 发 送 包 含 天 气 信息 的 SMS 短信 。 

Q 将 发 送 的 SMS 短信 写 人 数据 库 。 

(3) 浏览 和 设置 配置 信息 的 用 户 界面 

CD 将 用 户 设置 的 配置 信息 保存 到 数据 库 。 

@ 启动 时 读 取 数 据 库 中 的 配置 信息 。 

@ 恢复 默认 设置 。 

在 程序 的 需求 分 析 完 成 后 ,读者 已 经 基本 掌握 了 “天 气 预 报 短信 服务 软件 ”在 用 户 界 
面 和 内 部 功能 方面 的 需求 。 下 一 步 工作 是 根据 用 户 界 面 的 需求 ,详细 设计 每 一 个 用 户 界 
面 的 具体 内 容 , 以 及 软件 的 功能 模块 划分 和 模块 之 间 的 调用 关系 。 
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121 用 户 界面 设计 


根据 需求 中 的 用 户 界面 分 析 , 应 用 程序 应 包含 三 个 主要 的 用 户 界面 ,这 里 需要 进 一 
步 分 析 每 个 用 户 界 面 中 应 该 包含 哪些 显示 内 容 。 

在 “显示 天 气 预 报 的 用 户 界面 "中 ,根据 Google 可 以 提供 的 数据 ,在 界面 上 可 以 显示 
当前 的 天 气 状 况 , 包 括 城市 名 称 、 温 度 、 湿 度 、 风 向 、 雨 雪 情 况 和 获取 数据 时 间 等 信息 ;还 
可 以 显示 未 来 4 天 的 天 气 状况 ,但 仅 包 括 温度 和 雨 雪 情况 。 在 “显示 已 发 送 SMS 短信 的 
用 户 界面 ”中 ,应 显示 每 个 回复 短信 的 时 间 、 目 标 手 机 号 码 、 城 市 名 称 、 当 天 的 天 气 状况 和 
未 来 一 天 的 天 气 状况 。 在 “浏览 和 设置 配置 信息 的 用 户 界 面 "中 ,应 显示 获取 天 气 预 报 的 
目标 城市 名 称 、 获 取 数 据 的 频率 和 短信 的 关键 字 , 并 允许 用 户 设 置 是 否 提供 短信 服务 以 
及 是 否 记 录 回 复 的 短信 信息 。 
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根据 对 用 户 界面 显示 内 容 的 分 析 , 绘 制 出 用 户 界面 的 草图 ,如 图 11. 1 所 示 。 
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图 11.1 用 户 界 面 的 草图 


在 初步 完成 的 用 户 界面 设计 后 ,下 一 步 进入 应 用 程序 的 数据 库 设计 。 


11.22 数据 库 设 计 


本 示例 主要 有 两 种 数据 需要 存储 ,一 个 是 配置 信息 , 另 一 个 是 SMS 短信 服务 信息 。 
因为 配置 信息 的 数据 量 很 小 , 从 Android 支持 的 存储 方式 上 分 析 , 可 以 保存 在 
SharePreference, X f/F 3X SQLite 数据 库 中 。SMS 短信 服务 信息 是 一 个 随 着 时 间 推 移 而 
不 断 增加 的 数据 ,属于 文本 信息 ,而 且 有 固定 的 格式 ,因此 适合 使 用 SQLite 数据 库 进行 
存储 。 综 合 分 析 这 两 种 需要 存储 的 数据 ,选择 SQLite 数据 库 作 为 存储 数据 的 方法 。 

配置 信息 中 主要 保存 天 气 信息 查询 的 城市 名 称 ,访问 Google 更 新 天 气 信 息 的 频率 ， 
请 求 天 气 信 息 SMS 短信 的 关键 字 , 以 及 是 否 提 供 短信 服务 和 是 否 记 录 短 信服 务 内 容 。 
配置 信息 的 数据 库 表 结 构 如 表 11. 1 所 示 。 


表 11.1 配置 信息 的 数据 库 表 结构 


属 性 数据 类 型 说 RB 
_id integer 自动 增加 的 主键 
city_name text 进行 天 气 信息 查询 的 城市 名 
refresh_speed | text 进行 天 气 信息 查询 的 频率 ,单位 为 秒 /次 
Ragen a) EN 是 否 提供 短信 服务 , 即 接收 到 请 求 短 信 后 是 否 回复 包含 天 气 信息 的 
短信 
sms_info text 是 否 记 录 发 出 的 SMS 短信 的 信息 
key_word text 短信 服务 的 关键 字 , 用 以 确定 哪 条 短信 是 请 求 天 气 服务 的 短信 
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SMS 短信 服务 信息 主要 保存 请 求 服务 短信 的 发 送 者 、 短 信和 内容、 接收 时 间 和 回复 信 
息 的 内 容 。SMS 短信 服务 信息 的 数据 库 表 结 构 如 表 11. 2 Bron. 
表 11.2 SMS 短信 服务 信息 的 数据 库 表 结构 


属 性 数据 类 型 说 明 
_id integer 自动 增加 的 主键 
sms_sender text 请 求 服务 短信 的 发 送 者 
sms_body text 请 求 服务 短信 的 内 容 信息 
sms_receive_time text 接收 到 请 求 服务 短信 的 时 间 
return_result text 回复 短信 的 内 容 


1123. 程序 模块 设计 


从 功能 需求 上 分 析 , 可 以 将 整个 应 用 程序 划分 为 4 个 模块 ,分 别 是 用 户 界 面 \ 后 台 服 
务 ,数据库 适 配器 和 短信 监听 器 ,各 模块 之 间 的 关系 如 图 11. 2 Bron. 


用 户 界面 
天 气 信息 | nen PERZ lg 
后 台 服 务 信 
mium AEE -| etse d 
EU Um B i 
[ims | 信 
SQLite 数 据 库 二 一 “| 数据 库 适 配器 


图 11.2 模块 结构 图 


从 模块 结构 图 中 不 难看 出 ,后 台 服 务 是 整个 应 用 程序 的 核心 ,主要 包含 两 个 子 模块 ， 
一 个 是 “数据 获取 模块 ,负责 周期 性 的 从 Google 获取 天 气 信息 ; 另 一 个 是 “短信 服务 模 
块 ”, 负 责 处 理 接收 到 的 服务 请 求 短 信 ,并 发 送 包 含 天 气 信息 的 短信 。 后 台 服 务 由 用 户 界 
面 通过 Intent 启动 ,启动 后 的 后 台 服 务 可 以 在 用 户 界 面 关 闭 后 仍然 保持 运行 状态 ,直到 
用 户 通过 用 户 界 面 发 送 Intent 停止 服务 ,或 系统 因 资 源 不 足 而 强行 关闭 服务 。 

用 户 界 面 从 后 台 服 务 获取 天 气 信息 ,而 没有 直接 通过 网 络 访问 Google 的 天 气 数据 。 
之 所 以 这 么 设计 ,一 方面 是 因为 后 台 服 务 使 用 了 工作 线程 ,通过 后 台 服 务 获 取 天 气 数据 
可 以 避免 因 网 络 通信 不 畅 造 成 界面 失去 响应 ; 另 一 方面 ,在 用 户 关 闭 界面 后 ,后 台 服 务 仍 
然 需要 更 新 天 气 信息 ,以 保证 短信 服务 数据 的 准确 性 。 用 户 界 面 还 会 调用 数据 库 适 配 
器 ,向 SQLite 数据 库 中 写 人 , 读 取 配置 信息 ,或 对 SMS 短信 服务 信息 进行 操作 。 

短信 监听 器 是 一 个 BroadcastReceiver, 监 视 所 有 接收 到 的 短信 。 如 果 短 信 中 包含 用 户 
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自 定 义 的 关键 字 ,短信 监听 器 则 会 认为 这 条 短信 是 天 气 服务 请 求 短信 ,将 短信 的 相关 信息 
写 人 后台 服务 的 短信 服务 队列 。 当 然 , 如 果 用 户 在 配置 信息 中 选择 无 需 提供 短信 服务 , 短 
信 监 听 器 仍然 继续 监听 所 有 短信 ,只 是 后 台 服务 不 再 允许 将 服务 请 求 短信 写 和 人 服务 队列 。 
数据 库 适 配器 封装 了 所 有 对 SQLite 数据 库 操作 的 方法 ,用 户 界面 和 后 台 服 务 会 调 
用 它 实现 数据 库 操作 。 
在 完成 用 户 界面 设计 数据库 设计 和 模块 设计 后 ,程序 设计 阶段 基本 完成 ,下 面 进入 
程序 开发 阶段 。 
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11.31 文件 结构 与 用 途 


在 程序 开发 阶段 ,首先 确定 天气 预报 短信 服务 软件 ”的 工程 名 称 为 WeatherDemo， 
包 名 称 为 edu. hrbeu. WeatherDemo , 据 程序 模块 设计 的 内 容 , 建 立 WeatherDemo 示例 。 
WeatherDemo 示例 源 代码 的 文件 结构 如 图 11. 3 所 示 。 


GS YeatherDeno 由 -可 Android 1.5 
BB sre GS assets 
| BB edu, hrbeu. WeatherDeno 日 名 res 
| 国 Xi storyActivi ty. java BG draveble 
| SetupActivity. java i icon png 
| IR) Yestheràctivity. java sunny. png 
Di YeatherDeno java i tab history. png 
BB. edu, hrbeu. WeatherDeno DB tab_setup. png 
| Si Config. java | fi) tab_weather. png 
由 - 国 DBAdapter. java | BS layout 
` BH edu hrbeu FeatherDeno Service [À) data row xml 
四国 Snsgeceiver java DE) tab_history xml 
WeatherAdepter. java |o) LR) tab, setup. xml 
WeatherService. java | 国 tab weather. xml 
| GBH edu. hrbeu WeatherDeno. SMS | BE values 
国 sinplesns java i DÉI color. xml 
[J) SmsAdapter. java ii 国 strings. xml. 
i E edu. hrbeu WeatherDemo. feather | BI 
(00 8 [I] Forecast. java | Di ap xml 
| 国 feather, java EI Androi dani fest. xml 
由 吕 gen [Generated Java Files] ~B default. properties 


11.3  WeatherDemo 示例 的 源 代码 文件 


为 了 使 源 代码 文件 的 结构 更 加 清晰 ,WeatherDemo 示例 设置 了 多 个 命名 空间 ,分 别 
用 来 保存 用 户 界面 数据库 、 后 台 服 务 、SMS 短信 和 和 天气 数据 的 源 代码 文件 ,命名 空间 的 
名 称 以 及 说 明 参 考 表 11. 3。 


表 11.3 WeatherDemo 示例 的 命名 空间 


命名 空间 说 明 
edu. hrbeu. WeatherDemo 存放 与 用 户 界 面相 关 的 源 代码 文件 
edu. hrbeu. WeatherDemo. DB 存放 与 SQLite 数据 库 相 关 的 源 代码 文件 
edu. hrbeu. WeatherDemo. Service 存放 与 后 台 服 务 相 关 的 源 代码 文件 


命名 空间 
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续 表 
说 明 


edu. hrbeu. WeatherDemo. SMS 


存放 与 SMS 短信 相关 的 源 代码 文件 


edu. hrbeu. WeatherDemo. Weather 


存放 与 天 气 数据 有 关 的 源 代码 文件 


WeatherDemo 示例 将 不 同 用 途 的 源 代码 文件 放置 在 不 同 的 命名 空间 中 , 源 代码 文件 
的 名 称 和 用 途 可 以 参考 表 11. 4。 


ZS 11.4 WeatherDemo 示例 的 文件 用 途 说 明 


E 名 称 文 件 名 说 明 

HistoryActivity. java “历史 数据 ?页 的 Activity 
SetupActivity. java “系统 设置 ?页 的 Activity 

. WeatherDemo 
WeatherActivity. java “天 气 预 报 ” 页 的 Activity 
WeatherDemo. java 程序 启动 默认 的 Activity 
Config. java 保存 配置 信息 的 类 

. WeatherDemo. DB 
DBAdapter. java 数据 库 适配器 
SmsReceiver. java 短信 监听 器 

. WeatherDemo. Service WeatherAdapter. java 数据 获取 模块 
WeatherService. java 后 台 服 务 
SimpleSms. java 简化 的 SMS 短信 类 

. WeatherDemo. SMS 
SmsAdapter. java 短信 发 送 模块 

Forecast. java 未 来 天 气 信息 的 类 

WeatherDemo. Weather Weather. java 当前 天 气 信息 的 类 


Android 的 资源 文件 保存 在 /res 的 子 目录 中 。 其 中 /res/drawable 目录 中 保存 的 是 图 像 
文件 ,/res/layout 目录 中 保存 的 是 布局 文件 ,/res/values 目录 中 保存 的 是 用 来 定义 字符 串 
和 颜色 的 文件 ,/res/xml 目录 保存 的 是 XML 格式 的 数据 文件 。 所 有 在 程序 开发 阶段 可 以 
被 调用 的 资源 都 保存 在 这 些 目录 中 ,具体 每 个 资源 文件 的 用 途 可 以 参考 表 11.5。 


RUS 资源 文件 名 称 与 用 途 


资源 目录 件 说 明 
icon. png 图 标 文件 
sunny. png 调试 用 的 天 气 图 片 
drawable tab_history. png TabHost 中 * 历 史 数据 ?页 的 图 片 


tab_setup. png 


TabHost 中 “系统 设置 ”页 的 图 片 


tab_weather. png 


TabHost 中 “天 气 预报 ”页 的 图 片 
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续 表 
资源 目录 文 件 说 明 
data_row. xml “历史 数据 ?页 ListActivity 的 每 行 数据 的 布局 
tab_history. xml TabHost 中 “历史 数据 ”页 的 布局 
1 t 
iin tab setup. xml TabHost 中 “系统 设置 "页 的 布局 
tab_weather. xml TabHost 中 “天 气 预 报 ” 页 的 布局 
color. xml 保存 颜色 的 XML 文件 
values 
string. xml 保存 字符 串 的 XML 文件 
E 从 Google 下 载 的 天 气 数据 文件 。 在 程序 运行 时 没有 
m i. xm 
ü z 实际 作用 ,但 在 开发 过 程 中 可 以 让 读者 了 解数 据 格式 


在 定义 了 所 有 文件 和 类 的 用 途 后 ,下 


一 步 将 依据 程序 模块 结构 图 ( 见 图 11. 2) ,按照 


自 底 向 上 的 顺序 对 每 个 模块 进行 详细 的 介绍 。 自 底 向 上 介绍 有 利于 理解 模块 之 间 的 调 
用 关系 ,也 避免 了 在 介绍 上 层 模块 时 ,读者 不 了 解 所 调用 的 下 层 模 块 。 


1.32 数据 库 适 配器 


数据 库 适 配器 是 最 底层 的 模块 ,主要 用 于 封装 用 户 界面 和 后 台 服 务 对 SQLite 数据 
库 的 操作 。 数 据 库 适配器 的 核心 代码 主要 在 DBAdapter. java 文件 中 ,在 介绍 数据 库 适 
配器 的 核心 代码 前 ,首先 了 解 一 下 用 户 保存 配置 信息 的 类 文件 Config. java. 


Config. java 文件 的 全 部 代码 如 下 : 


1 package edu.hrbeu.WeatherDemo.DB; 

2 

3 public class Config { 

4 public static String CityName; 

5 public static String RefreshSpeed; 

6 public static String ProvideSnsService; 
7 public static String SaveSmsInfo; 

8 public static String KeyWord; 

9 

10 public static void LoadDefaultConfig() { 
in CityName- "New York"; 

12 RefreshSpeed- "60"; 

13 ProvidesmsService= "true"; 

14 SaveSmsInfo- "true"; 

15 Keyllord- "NY"; 

16 } 

17 } 


从 代码 中 不 难看 出 ,公有 静态 属性 CityName, RefreshSpeed, ProvideSmsService, 
SaveSmsInfo 和 KeyWord, 完 全 对 应 数据 库 中 保存 配置 信息 表 的 属性 ( 见 表 11. 1) 。 在 程 
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序 启动 后 ,保存 在 数据 库 中 的 城市 名 称 、 更 新 频率 、 是 否 提供 短信 服务 、 是 否 保存 短信 信 
息 和 关键 字 等 内 容 , 将 被 写 人 到 这 个 Config 类 中 , 供 其 他 模块 在 作 逻 辑 判断 时 使 用 。 

代码 第 10 行 的 LoadDefaultConfig() 函 数 ,保存 了 程序 内 置 的 配置 参数 。 此 函数 会 
在 两 个 情况 下 被 调用 ,一 是 用 户主 动 选择 “恢复 默认 设置 ”; 二 是 首次 启动 程序 时 ,用 来 初 
始 化 保存 配置 参数 的 数据 库 。 

DBAdapter 类 与 以 往 介 绍 过 的 数据 库 适 配器 类 相似 ,都 具有 继承 
SQLiteOpenHelper 的 帮助 类 DBOpenHelper。DBOpenHelper 在 建立 数据 库 时 ,同时 建 
立 两 个 数据 库 表 ,并 对 保存 配置 信息 的 表 进 行 了 初始 化 ,初始 化 的 相关 代码 在 第 42 一 
49 行 。 
private static final String DB NAME- "weather app.do"; 
private static final String DB TABIE OONFTG= "setup config"; 
private static final String DB CONFIG ID- "1"; 
private static final int DB VERSION- 1; 


public static final String KEY ID-" id"; 

public static final String KEY CITY NAME- "city name"; 

public static final String KEY REFRESH SPEED- "refresh speed"; 
public static final String KEY SMS SERVICE- "sms service"; 
public static final String KEY SMS INFO- "sms info"; 

public static final String KEY KEY WORD- "key word"; 


wo OI DO QN ro 


private static final String DB TABLE SMS- "sms data"; 

public static final String KEY SENDER- "sms sender"; 

public static final String KEY BODY- "sms body"; 

public static final String KEY RECEIVE TIME- "sms receive time"; 
public static final String KEY RETURN RESULT- "return result"; 


SO fF GB BORE S 


19 /* * HAS Helper 类 ,用 于 建立 ,更 新 和 打开 数据 库 * / 
20 private static class DBOpenHelper extends SQLiteOpenHelper ( 
21 public DBOpenHelper (Context context, String name, CursorFactory factory, int version) 


22 super (context, name, factory, version); 

23 } 

24 

25 private static final String DB CREATE OONFIG- "create table "+ 

26 IB TAEIE CONFIGH" ("+ KEY ID+" integer primary key autoincrement, "+ 
21 KEY CITY NAME+" text not null, "+KEY REFRESH SPEEDt" text, "+ 
28 KEY SMS SERVICE+" text, "+KEY SMS INFOt" text, "+ 

29 KEY KEY WORD+" text) ;"; 

30 

31 private static final String DB CREATE SMS- "create table "+ 


32 DB TABLE SS+" ("+ KEY ID+" integer primary key autoincrement, "+ 


228 人 six 


33 KEY SENIER* " text not null, "- KEY BODY+" text, "+ 
34 KEY RECEIVE TIME+" text, "+ KEY RETURN RESULT+ " text);"; 
35 

36 @ Override 

37 public void onCreate (SQLiteDatabase db) { 

38 . do.execSQL(DB CREATE CONFIG); 

39 . do.execSQL(DB CREATE SMS); 

40 

a // 初 始 化 系统 配置 的 数据 表 

42 Config. LoadDefaultConfig () ; 

43 ContentValues newValues= new ContentValues () ; 

44 newValues .put (KEY_CITY_NAME, Config.CityName) ; 

45 new/alues.put(KEY REFRESH SPEED, Config.RefreshSpeed) ; 

46 newValues .put (KEY_SMS SERVICE, Config. ProvideSmsService) ; 
47 new/alues.put(KEY SMS INFO, Config.SaveSnsInfo) ; 

48 new/alues.put(KEY KEY WORD, Config.KeyWord) ; 

49 . do.insert(DB TABLE CONFIG, null, newValues); 

50 ) 

51 

52 @ Override 

53 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
54 _db.execSQL ("DROP TABLE, IF EXISTS "+ DB TABLE CONFIG); 

55 _db.execSQL ("DROP TABLE, IF EXISTS "+ DB CREATE SMS); 

56 onCreate (_db); 

57 } 

58 1} 


在 DBAdapter 类 中 ,用 户 界面 会 调用 SaveConfig() 和 LoadConfigO ,向 SQLite 数据 
库 中 保存 和 读 取 配置 信息 。 保 存 配 置信 息 时 ,SaveConfig() 函 数 会 将 Config 类 中 的 公 
静态 属性 写 入 数据 库 ; 反 之 ,LoadConfig() 会 将 数据 库 中 的 配置 信息 写 和 人 Config 类 中 的 
公有 静态 属性 。SaveConfig() 和 LoadConfig() 的 代码 如 下 : 


1 public void SaveConfig() { 

2 ContentValues updateValues- new ContentValues () 7 

3 updateValues -put (KEY_CTTY NAME, Config.CityName); 

4 updateValues.put(KEY REFRESH SPEED, Config.RefreshSpeed) ; 

5 updateValues -put (KEY SMS SERVICE, Config.ProvideSmsService) ; 

6 updateValues.put (KEY SMS INFO, Config.SaveSnsInfo) ; 

3 updateValues.put(KEY KEY WORD, Config.KeyWord); 

8 do.update(DB TABLE OONFIG, updateValues, KEY Tür "- "TB CONFIG ID, null); 
9 ‘Toast .makelext (ocntext, "系统 设置 保存 成 功 ",，Toast .IENGIH SHORT) .show(); 
10 } 

n 

12 pblic void LoadConfig() { 


另 一 个 会 调用 DBAdapter 类 的 是 后 台 服 务 , 即 WeatherService 类 。 后 台 服 务 主要 调 


} 
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Cursor result= db.query (DB_TABIE, CONFIG, new String[] { KEY ID, KEY CITY NAME, 

KEY REFRESH SPEED,KEY SMS SERVICE, KEY SMS INFO, KEY KEY WORD}, 

KEY ID+"="+DB OONFIG ID, null, null, null, null); 
if (result.getCount()==0 | | !result.moveToFirst ()) ( 

retum; 

I 
Config.CityName- result.getString(result.getColumnIndex (KEY CITY NAME)); 
Config.RefreshSpeed- result.getString(result.getColumnIndex(KEY REFRESH SPFED)); 
Config.ProvideSmsService- result.getString (result.getColumnIndex(KEY SMS SFRVICE)); 
Config.SaveSmsInfo- result.getString(result.getColumnIndex (KEY SMS INFO)); 
Config.KeyWord- result .getString (result.getColumnIndex(KEY KEY WORD)); 
Tast .maksText (oontext, "系统 设置 读 取 成 功 "， Toast.IENGIH SHORT .show() ; 


用 SaveOneSms(SimpleSms sms) DeleteAllSms O fll GetAllSms O 函数 ,分 别 用 来 保存 


SMS 短信 记录 、 删 除 所 有 SMS 数据 记录 和 获取 所 有 SMS 数据 记录 。 在 GetAllSms( PR 


数 中 ,调用 了 一 个 私有 函数 ToSimpleSms (Cursor cursor) ,用 来 将 从 数据 库 获 取 的 数据 


转换 为 SimpleSms 对 象 数组 。SimpleSms 类 将 在 11. 3. 3 节 进 行 介绍 ,下 面 先 给 出 


SaveOneSms(SimpleSms sms) , DeleteAllSmsO fll GetAllSms() 函 数 的 代码 : 


1 
2 
x] 
4 
5 
6 
7 
8 
9 


public void SaveOneSms (SimpleSms sms) { 


) 


ContentValues new/alues- new ContentValues () ; 
newValues.put(KEY SENDER, sms.Sender) ; 

newValues .put (KEY BODY, sms.Body) ; 

newValues .put (KEY RECEIVE TIME, sms.ReceiveTime); 
newValues .put (KEY RETURN RESULT, sms.ReturnResult) ; 
db. insert (DB TABIE SMS, null, newValues) ; 


public long DeleteAl1sms() { 


} 


return db.delete(DB_ TABLE SMS, null, null); 


public SimpleSms[] GetAllSms() { 


} 


Cursor results=do.qery (IB PAHE SMS, new String[] ( KEY ID, KEY SENLER, 
KEY BODY, KEY RECEIVE TIME, KEY RETURN RESULT}, 
null, null, null, null, null); 

return ToSimplesms (results) ; 


private SimpleSns[] ToSimpleSns (Cursor cursor) { 


int resultCounts- cursor.getCount () ; 
if (resultCounts==0 || 'cursor.moveToFirst ()) { 
return null; 
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24 SimpleSns[] sms- new SimpleSms [resultCounts]; 

2 for (int i=0 ; i< resultCounts; i++){ 

26 sms [i]- new SimpleSms () ; 

27 sms [i] .Sender= cursor .get String (cursor .getColumnIndex (KEY SENDER) ) ; 

28 sms [i] .Body= cursor .getString (cursor .getColumIndex (KEY BODY)); 

29 sms [i] .ReceiveTime= cursor.getString (cursor .getColumnIndex (KEY RECEIVE TIME) ) ; 
30 sms [i] .RetumResult= cursor.getString (cursor.getColumIndex (KEY RETURN RESULT) ) ; 
31 cursor .moveToNext () ; 

32 } 

33 return sms; 

34 ] 


1133 短信 监听 器 


短信 监听 器 本 质 上 是 BroadcastReceiver, 用 于 监听 Android 系统 所 接收 到 的 所 有 
SMS 短 消 息 ,可 以 在 应 用 程序 关闭 后 仍然 继续 运行 ,核心 代码 在 SmsReceiver. java 文件 
中 。 同 样 在 介绍 SmsReceiver 类 前 , 先 说 明 用 来 保存 SMS 短信 内 容 和 相关 信息 的 
SimpleSms 类 。android. telephony. gsm. SmsMessage 是 Android 提供 的 短信 类 ,但 这 里 
需要 一 个 更 精简 小巧 的 类 ,保存 少量 的 信息 ,因此 构造 了 SimpleSms 类 , 仅 用 来 保存 短 
信 的 发 送 者 、 内 容 、 接 收 时 间 和 返回 结果 。 这 里 的 “返回 结果 ” 指 的 是 返回 包含 天 气 信息 
的 短信 和 内容。 

SimpleSms. java 文件 完整 代码 如 下 : 


1 package edu.hrbeu.WeatherDemo.SMs; 

2 import java.text.SimpleDateFormat; 

3 

4 public class SimpleSms { 

5 public String Sender; 

6 public String Body; 

7 public String ReceiveTime; 

8 public String ReturrResult; 

9 

10 public Simplesms (){ 

n j 

12 public SimpleSns (String sender, String body) ( 

13 this.Sender- sender; 

14 this.Body- body; 

15 SimpleDateFonmat tempDate- new SimpleDateFormat ("yyyy- MM dd" " "+ "hh:mm: ; 
16 this.ReceiveTime- tenpDate. format (new java.util.Date ()); 
17 this.ReturnResult- mm: 

18 } 

19 } 


代码 第 5 行 到 第 8 行 的 属性 Sender, Body, ReceiveTime 和 ReturnResult ,分 别 表示 
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SMS 短 信和 的 发 送 者 、 内 容 、 接 收 时 间 和 返回 结果 。 代 码 的 第 15 行 和 第 16 行 在 
SimpleSms 类 的 构造 函数 中 ,直接 将 系统 时 间 以 “年 -月 -日 小 时 :分 : 秒 ” 的 格式 保存 在 
ReceiveTime 属性 中 。 

SmsReceiver 类 继承 BroadcastReceiver, 重 载 了 onReceive MM, ABA AWA 
和 关键 字 的 识别 并 不 复杂 ,只 要 接收 android. provider. Telephony. SMS_RECEIVED 类 
型 的 系统 消息 , 则 表明 是 Android 系统 接收 到 了 短信 ;将 短信 的 内 容 拆 分 后 ,判断 消息 内 
容 是 否 是 配置 信息 中 定义 的 关键 字 , 即 可 判断 该 短信 是 否 为 天 气 服务 请 求 短信 。 下 面 给 
出 SmsReceiver. java 文件 的 核心 代码 : 


1 public class SmsReceiver extends BroadcastReceiver( 
2 private static final String SMS ACTION- "android.provider.Telephony.SMS RECEIVED"; 
3 
4 @ Override 
5 public void onReœive (Context context, Intent intent) { 
6 if (intent .getAction() «equals (SMS_ACTION)) { 
y Bundle bundle- intent .getExtras () ; 
8 if (bundle !=null) { 
9 Object [] objs= (Œœject[]) bundle.get ("pdus") ; 
0 SmsMessage[] messages- new SmsMessage [objs. length] ; 
1 for (int i=0; i<œjs.length; i++){ 
12 messages [1]= SneMessage.CreateFrarFaa( (oyte[]) dojs[i])+ 
3 } 
4 String smsBody- messages [0] .getDisplayMessageBody () ; 
5 String smsSender= messages [0] .getDisplayOriginatingAddiress () 7 
6 if (smsBody.trim() «equals (Config.KeyWord) && Config. ProvideSmsService.equals 
("true") ) { 
ifi SimpleSms simpleSms= new SimpleSms (smsSender, smsBody) ; 
8 WeatherService.RequerSMSService (simplesms) ; 
9 Toast .makeText (context，" 接 收 到 服务 请 求 短 信 "， ‘Toast .LENGTH_SHORT) . 
shw(); 
20 } 
2t } 
22 } 
23 } 
24 } 


代码 第 10 行将 带 有 pdus 字符 串 特 征 的 对 象 ,通过 Bundle. get() 函 数 提取 出 来 ,并 
在 代码 第 12 行使 用 SmsMessage. CreateFromPdu O 函数 构造 SmsMessage 对 象 。 在 代 
码 第 11 行使 用 循环 语句 是 因为 接收 到 的 短信 可 能 不 止 一 条 ,但 从 第 14 行 和 第 15 行 代码 
看 ,这 里 只 处 理 第 1 条 短信 。 代 码 第 17 行 构造 SmpleSms 对 象 ,然后 在 代码 第 18 行 调 
用 WeatherService 类 的 RequerSMSService () FR Zt. f£. SimpleSms 对 象 添加 到 短信 队 
列 中 。 

最 后 ,在 AndroidManifest. xml 文件 中 注册 短信 监听 器 SmsReceiver, 并 声明 可 以 接 
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收 短信 的 用 户 许可 android. permission. RECEIVE_SMS。 需要 注意 的 是 如 果 注 册 的 组 
件 不 在 根 命 名 空间 中 , 则 需要 将 子 命名 空间 写 在 类 的 前 面 ,例如 下 面 在 代码 第 1 行 中 , 因 
为 SmsReceiver. java 文件 在 edu. hrbeu. WeatherDemo. Service 命名 空间 下 ,而 不 在 根 命 
名 空间 edu. hrbeu. WeatherDemo 下 ,因此 注册 组 件 时 需要 在 类 名 SmsReceiver 前 添加 


. Service, 


< receiver android:name- ".Service.SmsReceiver" > 
< intent- filter» 
<action android:name= "android.proviœr. Telephony 26 RECEIVED" /> 
< /intent- filter» 


< /receiver> 


ano 50€ H PB 


<uses- permission android:name- "android.permission.RECEIVE SMS"/» 


134 BARS 


后 台 服 务 是 WeatherDemo 示例 的 核心 模块 ,在 用 户 启动 后 持续 在 后 台 运 行 ,直到 用 
户 手 动 停止 服务 。 后 台 服 务 主要 有 两 个 功能 ,一 是 发 送 包含 天 气 信息 的 SMS 短信 (短信 
发 送 模块 ), 二 是 周期 性 的 获取 Google 的 天 气 数 据 (数据 获取 模块 ) 。 


l. 短信 发 送 模块 


后 台 服 务 在 单独 的 线程 上 运行 ,首先 调用 ProcessSmsList() 函数 ,检查 短信 队列 中 
是 否 有 需要 回复 的 短信 ,然后 调用 GetGoogleWeatherData O 函数 获取 天 气 数 据 , 最 后 线 
程 暂停 1 秒 , 以 释放 CPU 资源 。WeatherDemo 示例 后 台 服 务 的 核心 代码 在 
WeatherService. java 文件 中 ,下 面 是 线程 调用 郴 数 的 部 分 代码 : 


1 private static ArrayList« SimpleSms> smsList- new Arraylist« SimpleSns> (); 
2 

3 private Runnable backgroudWork- new Runnable () { 
4 @ Override 

5 public void run() { 

6 try{ 

7 while (!Thread.interrupted()) { 

8 ProcessSnsList () ; 

9 GetGoogleWieatherData () ; 

10 Thread.sleep (1000) ; 

n } 

12 } catch (InterruptedException e) { 

13 e.printStackTrace () ; 

14 } 

15 } 

16 k} 


ProcessSmsList() 函 数 用 来 检查 短信 和 列表 smsList, 并 根据 Weather 类 中 保存 的 天 气 
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数据 ,向 请 求 者 的 发 送 回复 短信 。WeatherService. java 文件 的 ProcessSmsList() K BE 
码 如 下 : 


1 private void ProcessSmsList () ( 

2 if (smsList.size()==0) { 

3 return; 

4 } 

5 SmsManager smsManager- SmsManager .getDefault () ; 

6 PendingIntent mPi= PendingIntent .getBroadcast (this, 0, new Intent (), 0); 
7 while (smsList.size()> 0) { 

8 SimpleSns sms= smsList.get (0) ; 

9 smsList remove (0) ; 

10 smsManager.sendTextMessage (sms.Sender, null, Weather.GetSmsMsg(), mPi, null); 
un sms.ReturnResult- Weather .GetSmsMsg () ; 

12 SaveSmsData (sms) ; 

13 ) 

14 } 


发 送 短信 是 使 用 SmsManager 对 象 的 sendTextMessage() 方 法 ,该 方法 一 共 需 要 5 
个 参数 ,第 1 个 参数 是 收 件 人 地 址 ;第 2 个 参数 是 发 件 人 地 址 ;第 3 个 参数 是 短信 正文 ;第 
4 个 参数 是 发 送 服务 ;第 5 个 参数 是 送 达 服务 。sendTextMessage() 方 法 的 收 件 人 地 址 和 
短信 正文 是 不 可 为 空 的 参数 ,而 且 一 般 GSM 规范 要 求 短信 和 内容 要 控制 在 70 个 汉字 以 
内 。 代 码 第 8 行 的 Weather. GetSmsMsg() ,用 来 获得 供 回复 短信 使 用 的 天 气 信息 ,因为 
考虑 到 短信 的 字数 限制 , 仅 返 回 当 天 和 未 来 一 天 的 天 气 状况 。 下 面 分 别 给 出 Weather. 
java 和 Forecast. java 文件 的 完整 代码 。 

Weather. java 文件 的 代码 如 下 : 


1 package edu.hrbeu.WeatherDemo.Weather; 

2 import android.graphics.Bitmap; 

3 

4 public class Weather { 

5 public static String city; 

6 public static String forecase date; 

7 public static String current date time; 
8 public static String current condition; 
9 public static String current temp; 

10 public static String current humidity; 
n public static String current image url; 
12 public static Bitmap current image; 

13 public static String current wind; 

14 

15 public static Forecast[] day- new Forecast [4]; 
16 


17 static ( 
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} 


for (int i=0; i«day.length; i++){ 
day [i]= new Forecast () 
} 


public static String GetSmeMsg() { 


msgt = current conditiont", "+ current tempt". "7 
msgt = day[0] .day of week*", "+ day[0] .conditiont ", 


day [0] -hight "/"+ day [0] .low; 
return msg; 


Forecast. java 文件 的 代码 如 下 ; 


1 package edu.hrbeu.WeatherDemo.Weather; 
2 import android.graphics.Bitmap; 
3 

4 public class Forecast ( 

5 public String day of week; 
6 public String low; 

7 public String high; 

8 public String image url; 

9 public Bitmap image; 

10 public String condition; 
1i } 

2. 数据 获取 模块 


天 气 数据 是 从 Google 提供 的 Web Service 中 获取 的 ,数据 的 获取 地 址 是 http:// 
www. google. com/ig/api? hl = en& weather = New% 20York。 其 中 ,New% 20York 表 
示 获 取 纽 约 (New York) 的 天 气 数据 ,% 20 表示 一 个 空格 。 读 者 可 以 替换 New 
20York ,并 将 新 的 地 址 输入 Web 浏览 器 ,在 浏览 器 中 可 以 直接 看 到 XML 格式 的 天 气 


数据 。 


在 资源 目录 中 的 /res/xml/api. xml 文件 ,就 是 2009 年 9 月 22 日 获取 的 纽约 天 气 数 
据 。 在 程序 资源 中 保留 api. xml 文件 ,主要 是 用 来 帮助 读者 分 析 XML 数据 格式 ,在 程序 


运行 期 间 并 不 访问 该 文件 。api. xml 文件 的 内 容 如 下 : 


1 
2 
3 


<?xml versione "1.0" encoding- "UTE- 8"?» 
«xml api reply version- "1"> 


«weather module iœ "0" tab id- "0" mobile row- "0" mobile zipped- "1" row- "0" sectione "0" 


> 


my 


o 0 A om wm 心 


o o 320050 soo 
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< forecast_information> 
€ city data- "New York, NY"/> 
«postal code data= "New York"/> 
«latitude e6 data= /> 
< longitude e6 data="/> 
< forecast date data- "2009- 09- 22"/> 
«current date time data= "2009- 09- 22 16:51:00+ 0000"/> 
«unit system data- "US"/» 
< /forecast information» 


Xcurrent conditions» 
< condition data= "Mostly Cloudy"/> 
«temp f data= "72"/> 
«temp c data= "22"/» 
< humidity data= "Humidity: 71$ "/> 
< icon data- "/ig/images/weather/mostly cloudy.gif"/» 
«wind condition data= "Wind: N at 6 mph"/> 
< /current. conditions» 


< forecast conditions» 
«day of week data= "Tue"/» 
< low data- "65"/> 
« high data= "76"/> 
< icon data= "/ig/images/weather/mostly sunny.gif"/» 
« condition data- "Partly Sunny"/> 
< /forecast. conditions» 


«forecast conditions» 
«day of week data= "Wed"/» 
< low data "68"/> 
« high data= "79"/> 
< icon data= "/ig/images/weather/chance of stom.gif"/> 
< condition data= "Chance of Stom"/> 
« /forecast conditions» 


«forecast conditions» 
«day of week data= "Thu"/> 
< low data- "61"/> 
« high data- "83"/> 
< icon data- "/ig/images/weather/chance of stomm.gif"/» 
< condition data= "Chance of Stomm"/> 
< /forecast conditions» 


«forecast conditions» 
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<day of week data- "Fri"/» 
< low data- "54"/> 
« high data="72"/> 
< icon data= "/ig/images/weather/sunny.gif"/» 
< condition data= "Clear"/> 
< /forecast conditions» 
< /weather> 


< Zant api reply» 


所 forecast_information 之 标签 内 的 数据 是 天 气 预 报 的 城市 和 时 间 等 基本 信息 ， 
< 一 current_conditions 之 标签 内 的 是 当时 的 天 气 状 况 ,4 个 所 forecast_conditions 二 标签 是 
未 来 4 天 的 天 气 情况 。 在 api. xml 文件 中 ,还 提供 了 能 够 反映 天 气 情况 的 图 标 地 址 ,例如 
第 19 行 .第 27 行 和 第 35 行 等 。 

WeatherAdapter 类 实现 了 利用 URL 获取 位 图 的 私有 函数 Get URLBitmap() ,以 及 
用 来 下 载 和 解析 XML Be He AY ZS A R XC GetWeatherData ()。 后 台 服 务 在 调用 
GetWeatherData O PR Zt fi jr Google 提供 的 天 气 数据 时 ,会 不 断 调用 Get URL Bitmap O 
函数 ,将 XML 数据 中 的 天 气 图 标 根据 图 标 地 址 下 载 到 本 地 保存 。GetURLBitmap() PR 


数 的 代码 如 下 : 
1 private static Bitmap GetURIBitmap (String urlString){ 
2 URL url= null; 
3 Bitmap bitmap= null; 
4 try { 
5 url= new URL ("http://www.google.com"+ url String) ; 
6 } 
7 catch (MalformedURIException eil 
8 e.printStackTrace () ; 
9 } 
10 
u try{ 
12 HttpURLConnection conn= (HttpURIConnection) url.openConnection(); 
13 conn.connect () ; 
14 InputStream is- conn.getInputStream() ; 
15 bitmap- BitmapFactory.decodeStream(is) ; 
16 is.close(); 
17 Jcatch (IOException e) { 
18 e.printStackTrace () 7 
19 } 
20 return bitmap; 
a 3 


第 12 行 代码 构造 了 支持 HTTP 功能 的 URLConnection ,连接 后 在 第 14 行 返回 字 节 
流 , 第 15 行使 用 字 节 流产 生 位 图 ,最 后 在 第 16 行 关闭 字 节 流 。 
Get WeatherData() 函数 首先 根据 指定 的 URL 地 址 ,从 网 络 获取 字 节 流 数据 ,然后 调 
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用 轻 量 级 XML 解析 器 XmlPullParser 对 天 气 数据 进行 解析 ,并 将 解析 结果 保存 在 
Weather 类 的 公有 静态 属性 中 。GetWeatherData() 函 数 的 代码 如 下 : 


1 public static void GetWeatherData() throws IOException, Throwable { 
2 String queryString- "http://www.google.can/ig/api? weather= "+ Config.CityName; 
3 URL aURL- new URL (queryString.replace (" ", "$ 20")); 
4 URLConnection conn= aURL.gpenConnection () 7 
5 conn.connect () ; 
6 InputStream is- conn.getInputStream(); 
7 
8 XmlPullParserFactory factory- XmlPullParserFactory.newInstance|() ; 
9 factory.setNamespaceAware (true) ; 
0 XmlPullParser parser- factory.newPu 0; 
1 parser.setInput (is, "UTF- 8"); 
12 
3 int dayCounter= 0; 
4 while (parser .next () != XmlPullParser.END DOCUMENT) { 
5 String element- parser.getNare () ; 
6 if (element !- null && element .equals ("forecast_information")) { 
7 while (trus) { 
8 int eventCode= parser.next (); 
9 element= parser .getName () ; 
20 if (eventCode= = XmlPullParser.START TAG)( 
21 if (element.equals ("city")) { 
22 Weather.city- parser.getAttributeValue (0) ; 
23 Jelse if (element .equals ("current date time"))( 
24 Weather.current date time- parser.getAttributeValue (0) ; 
25 } 
26 } 
27 
28 if (element .equals ("forecast_information") && 
29 eventCode- = Xml Pull Parser .END_TAG) { 
30 break; 
31 } 
32 } 
33 } 
34 if (element !=null && element .equals ("current conditions") ){ 
35 while (true) { 
36 int eventCode- parser.next () ; 
3] element- parser.getNare () ; 
38 if (eventCode== XmlPullParser.START TAG)( 
39 if (element.equals ("condition") ) ( 
40 Weather.current condition- parser.getAttributeValue (0) ; 
Pu Jelse if (element .equals ("temp f"))( 
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42 Weather.current temp- parser.getAttributeValue (0) ; 
43 Jelse if (Clement .equals ("humidity")) { 
44 Weather.current humidity- parser.getAttributeValue (0) ; 
45 Jelse if (element .equals ("wind condition"))( 
46 Weather.current wind- parser.getAttributeValue (0) ; 
47 Jelse if (element .equals ("icon") ) { 
48 Weather.current image url- parser.getAttributeValue (0) ; 
49 Weather.current image- GetURIBitmap (Weather.current image url); 
50 ) 
SL } 
52 
53 if (element.equals("current conditions") && 
54 eventCode- = XmlPullParser.FND TAG)( 
55 break; 
56 ) 
57 } 
58 } 
59 if (element !=null && element .equals ("forecast_conditions")) { 
60 while (true) { 
6l int eventCode= parser.next (); 
62 element- parser.getName () ; 
63 if (eventCode- = XmlPullParser.START TAG)( 
A if (element.equals ("day of week"))( 
65 Weather.day[dayCounter].day of week- parser. 
getAttributeValue (0) ; 
66 Jelse if (element .equals ("low") ) { 
67 Weather .day [dayCounter] .1ow- parser .getAttributeValue (0) 7 
68 Jelse if (element.equals ("high") ) ( 
69 Weather .day [dayCounter] .high= parser.getAttributeValue (0) ; 
70 Jelse if (element .equals ("icon") ) { 
H Weather.day[dayCounter] .imege url= parser.getAttributeValue (0) ; 
72 Weather .day [dayCounter] . image= GetURLBitmap (Weather. day [dayCounter] . image ` 
url); 
73 Jelse if (element .equals ("condition")) { 
74 Weather.day [dayCounter] .condittiaw= parser .getAttributeValue (0) ; 
75 i 
76 } 
TI 
78 if (element .equals ("forecast conditions") && 
79 eventCode= = XmlPullParser.FND TAG)( 
80 dayCountert + ; 
81 break; 
82 ) 
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84 } 

85 } 

86 is.close(); 
87 } 


最 后 ,在 AndroidManifest. xml 文件 中 注册 WeatherService ,并 声明 连接 互联 网 和 发 
送 SMS 短信 的 两 个 用 户 许可 。 

1 < service android:name- ".Service.WeatherService"/> 

2 <uses- permission android:name- "android.permission. INTERNET" /> 

3 < uses- permission android:name- "android.permission.SEND SMS"/> 


1135 用 户 界 面 


在 用 户 界面 设计 上 ,采用 可 以 在 多 个 分 页 上 快速 切换 的 Tab 标签 页 。 与 以 往 介 绍 过 
的 Tab 标签 页 的 使 用 方法 不 同 , WeatherDemo 示例 的 Tab 标签 页 将 每 个 标签 页 与 一 个 
Activity 关联 在 一 起 ,这 样 做 的 好 处 就 是 可 以 将 不 同 标签 页 的 代码 放 在 不 同 的 文件 中 ,而 
且 每 个 标签 页 都 可 以 有 独立 的 选项 菜单 。 

WeatherDemo 类 是 继承 TabActivity 的 Tab 标签 页 , 共 设 置 3 个 标签 页 。TABI 标 
签 页 的 标题 为 “天 气 预 报 ”, 关 联 的 Activity 为 WeatherActivity; TAB2 标签 页 的 标题 为 
“历史 数据 ,关联 Activity 为 HistoryActivitys; TAB3 标签 页 的 标题 为 “系统 设置 *, 关 联 
Activity 为 SetupActivity, 

WeatherDemo. java 文件 的 完整 代码 如 下 : 


1 package edu.hrbeu.WeatherDemo; 

2 

3 import android.app.TabActivity; 

4 import android.content.Intent; 

5 import android.os.Bundle; 

6 import android.widget.TabHost; 

7 

8 public class WeatherDemo extends TabActivity ( 

9 @ Override 

10 public void onCreate (Bundle savedInstanceState) { 

n super .onCreate (savedInstanceState) ; 

12 

13 TabHost tabHost- getTabHost () ; 

14 tabHost .addTab (tabHost .newTabSpec ("TABI") 

15 -set Indicator "KA DIR ", getResources () .getDrawable (R.drawable.tab_weather) ) 
16 .setContent (new Intent (this, WeatherActivity.class))); 

17 

18 tabHost.addTab (tabHost .newTabSpec ("TAB2") 

19 -set Indicator ("Jj dr BUH ", getResources () .getDrawable (R.drawable.tab_history)) 


20 -SetContent (new Intent (this, HistoryActivity.class) )); 
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a 
22 tabHost .addTab (tabHost .newTabSpec ("TAB3") 

23 «set Indicator ("% Hé i Fi ", getResources () .getDrawable (R.drawable.tab setup)) 
24 .setContent (new Intent (this, SetupActivity.class))); 

25 ) 

26 } 


WeatherDemo. java 中 的 代码 只 是 用 户 界 面 的 框架 ,设置 了 Tab 标签 页 的 图 标 、 标 题 
和 所 关联 的 Activity, 标 签 页 中 的 具体 显示 内 容 还 要 依赖 于 每 个 Activity 所 设置 的 界面 
布局 。 下 面 就 分 别 介 绍 WeatherActivity, HistoryActivity 和 SetupActivity. 


1. WeatherActivity 


WeatherActivity 主要 用 来 显示 天 气 信 息 , 如 图 11. 4 所 示 。WeatherActivity 在 启动 
时 并 不 能 够 显示 最 新 的 天 气 信 息 , 用 户 需 要 通过 选项 菜单 的 “启动 服务 ?开启 后 台 服 务 ， 
然后 单 击 “ 刷 新 ”按钮 获取 最 新 的 天 气 状况 。 此 外 ,选项 菜单 还 提供 “停止 服务 ”和 “退出 ” 
选项 。 

WeatherActivity 使 用 的 布局 文件 是 tab_weather. xml, 这 是 个 较为 繁琐 的 界面 布 
局 ,多 次 的 使 用 了 垂直 和 水 平 的 线性 布局 。WeatherActivity 的 界面 布局 和 代码 并 不 难 理 
解 , 因 此 这 里 不 再 给 出 WeatherActivity. java 和 tab_weather. xml 具体 代码 。 


2. HistoryActivity 

HistoryActivity 主要 用 来 显示 SQLite 数据 库 中 的 短信 服务 信息 ,显示 的 内 容 包 括 
发 送 者 的 手机 号 码 、 时 间 和 回复 短信 和 内容, 如 图 11.5 所 示 。 为 了 能 够 以 列表 的 形式 显示 
多 行 数据 ,并 定制 每 行 数据 的 布局 ,使 用 了 以 往 章 节 没 有 介绍 过 的 ListActivity 
(Android. app. ListActivity) 。 


Di aa 14:22 


WeatherDemo 


图 11.4 WeatherActivity 用 户 界面 


EWE 综合 示例 设计 与 开发 241 


Di BME 16:59 


WeatherDemo 


: 1300000000 , 2009-09-25 02:34:54 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000001 , 2009-09-25 02:34:57 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000002 , 2009-09-25 02:35:00 
, Clear, 63. Fri, Mostly Sunny, 72/52 


: 1300000003 , 2009-09-25 02:35:02 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000004 , 2009-09-25 02:35:04 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000005 , 2009-09-25 02:35:07 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000006 , 2009-09-25 02:35:09 
, Clear, 63. Fri, Mostly Sunny, 72/52 
: 1300000007 , 2009-09-25 02:35:13 
, Clear, 63. Fri, Mostly Sunny, 72/52 


11.5 HistoryActivity 用 户 界 面 


ListActivity 可 以 不 通过 setContentView() 设 置 布 局 ,也 不 必 重 载 onCreate O PAK, 
而 直接 将 显示 列表 加 载 到 ListActivity ,增加 了 使 用 的 便利 性 。 在 WeatherDemo 示例 中 ， 
仍然 使 用 setContentView() 设 置 布局 ,这 样 做 的 好 处 是 可 以 在 界面 中 设置 更 为 复杂 的 显 
示 元 素 ,例如 在 列表 上 方 增加 了 提示 信息 “SQLite 数据 库 中 的 短信 服务 信息 ”。 下 方 的 代 
DE HistoryActivity. java 文件 的 onCreate O 函数 中 的 设置 布局 和 加 载 适配器 的 关键 
代码 : 


1 setContentView(R.layout.tab history); 
2 setListAdapter (dataAdapter) ; 


tab_history. xml 是 HistoryActivity 的 布局 文件 ,下 面 先 分 析 一 下 tab_history. xml 
的 内 容 。tab_history. xml 文件 的 完整 代码 如 下 : 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2 < LinearTayout. »mlns:android= "http: //schemas .android.car/apk/res/android" 
3 android:orientation- "vertical" 

4 android:layout width= "fill parent" 

5 android:layout height= "fill parent" 

6 android:background- "@ drawable/black"» 

7 
8 
9 


<TextView  android:layout width- "wrap content" 
android:layout height- "wrap content" 
10 android:text- "SoLite 数 据 库 中 的 短信 服务 信 
< /TextView> 
12 < ListView android:id- "@ android:id/list" 
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13 android:layout width- "fill parent" 
14 android:layout height= "wrap content" 
15 android:layout marginTop- "2dip"> 

16 < /ListView> 


17  «/Linearlayout^ 


tab. history. xml 在 代码 的 第 12 47 858 16 行 增加 了 ListView 控件 ,并 使 用 系统 的 
ID 值 *@android:id/list”, ListView 的 数据 适配器 是 通过 setListAdapter(dataAdapter) 
设置 的 。ListView 使 用 的 是 自 定义 布局 ,布局 保存 在 data. row. xml 文件 中 ,data_row. 
xml 的 完整 代码 如 下 : 


< LinearTayout xmlns:android= "http://sdhemas.android.om/apk/res/android" 
android:orientation- "horizontal" 
android:layout width- "fill parent" 
android:layout height= "fill parent" 
android:background- "@ drawable/white" 
android:layout marginTop- "2dip"> 


< Linearlayout android:orientation= "vertical" 
android: layout_width= "fill parent" 
android:layout height- "fill parent"^ 
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< TextView android:id "@ + id/data row 01" 
android: layout_gravity= "center vertical" 
android: layout_width= "fill parent" 
android: layout_height= "wrap content" 
android:textSize- "12dip" 
android:textColor- "@ drawable/black"/> 
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< TextView android:id= "@ + id/data row 02" 

20 android:layout gravity- "center vertical" 

a android:layout width= "fill parent" 

22 android:layout height- "wrap content" 

23 android:textSize- "12dip" 

24 android:textColor- "à drawable/black" 

25 androidilayout marginTop= "3dip"/> 

26 < /Linearlayout> 

27 < /Linearlayout> 

Android 提供 的 数据 适配器 仅 允 许 保 存 字符 串 数 组 或 列表 对 象 ,如 果 和 希望 使 用 自 定 
义 布局 , 则 需要 实现 自 定 义 的 数据 适配器 ,并 继承 Android 提供 的 BaseAdapter 
(Android. widget. BaseAdapter) 对象。 自 定 义 的 数据 适配器 在 SmsAdapter. java 文件 
中 ,其 完整 代码 如 下 : 


1 package edu.hrbeu.WeatherDemo.SMS; 
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20 
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import android.content.Context; 

import android.view.layoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 

import android.widget.BaseAdapter; 

import android.widget.TextView; 

import edu.hrbeu.WeatherDano.DB.DBAdapter; 
import edu.hrbeu.WeatherDano.R; 


public class SmsAdapter extends BaseAdapter{ 
private LayoutInflater mInflater; 
private static DBAdapter dbAdapter ; 
private static SimpleSns[] snsList ; 


public SmsAdapter (Context context) { 
mInflater- LayoutInflater. fran (context) ; 
dbAdapter= new DBAdapter (context) ; 
dondapter .open () ; 
smsList= dbAdapter .GetAllSms () ; 


public static void RefreshData () { 
smsList- doAdapter .GetAllSms () ; 
} 
@ Override 
public int getCount () { 
if (smsList== null) 
return 0; 
else 
return smsList.length; 
) 
@ Override 
public Object getItem(int position) { 
if (smsList== null) 
return 0; 
else 
return smsList [position]; 
) 
@ Override 
public long getItemId(int position) { 
return position; 
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46 

47 @ Override 

48 public View getView(int position, View convertView, ViewGroup parent) { 

49 ViewHolder holder; 

50 if (convertView= = null) { 

51 convertView-mInflater.inflate(R.layout.data row, null); 

52 holder- new ViewHolder (); 

53 holder.textRow01= (TextView) convertView.findViewById(R.id.data row 01); 

54 holder.textRow02= (TextView) convertView.findViewById(R.id.data row 02); 

55 convertView.setTag (holder) ; 

56 } 

5] else( 

58 holder- (ViewHolder) convertView.getTag(); 

59 } 

60 

6l if (smsList !=null){ 

62 String rwW0lMsg= "( "+ Positicn+m "e" 发 送 者 : "+ list [position].Sender- ", "+ 
smsList[positicn] .ReceiveTirme; 

63 holder.textRow01.setText (row01Msg) ; 

64 holder.textRow02.setText (smsList [position] .ReturnResult) ; 

65 ) 

66 return convertView; 

67 ) 

68 

69 private class ViewHolder( 

70 TextView textRow01; 

7 TextView textRow02; 

72 } 
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继承 BaseAdapter 类 , 则 首先 要 重 载 4 个 函数 ,包括 getCount (), getItem On, 
getItemId() 和 getView() 。LayoutInflater 是 将 XML 文件 中 的 布局 映射 为 View 对 象 的 
类 ,在 代码 第 14 行进 行 了 声明 ,在 代码 第 51 行 ,将 data row. xml 文件 映射 为 View 对 
象 。 代 码 第 70 行 和 第 71 行 的 内 容 , 需 要 对 应 data row. xml 文件 中 的 界面 元 素 。 


3. SetupActivity 


SetupActivity 主要 用 来 保存 和 恢复 用 户 设置 的 运行 参数 ,第 一 次 启动 或 恢复 默认 设 
置 (在 选项 菜单 中 ) 后 ,界面 上 会 显示 系统 的 默认 设置 ， 


DME 14:23 
包括 城市 名 称 .更 新 频率 .是 否 提供 短信 服务 .是否 记 录 
短信 服务 数据 信息 和 短信 服务 的 关键 字 。 - e, 
SetupActivity 用 户 界面 如 图 11.6 Aras. 
SetupActivity. java 文件 的 主要 功能 集中 在 


RestoreDefaultSetup()、UpdateUI() 和 SaveConfig() 三 
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个 函数 上 。RestoreDefaultSetup() 用 来 恢复 系统 的 默认 配置 ; UpdateUI() 会 根据 保存 在 
Config 类 中 的 数据 更 新 SetupActivity 的 界面 控件 ;SaveConfig() 根 据 界面 配置 更 改 
Config 类 ,然后 调用 数据 库 适 配器 的 DBAdapter. SaveConfig O PR ZI 5 Config 类 中 的 配 
置 数据 写 入 数据 库 。 


private void RestoreDefaultSetup() { 
Config. LoadDefauiltConfig() ; 
UpdateUI () ; 

dbAdapter. SaveConfig() ; 


private void UpdatelI () { 
cityNameView.setText (Config.CityName) ; 


1 
2 
3 
4 
5. } 
6 
7 
8 
9 refreshSpeedView.setText (Config.RefreshSpeed) ; 


0 smsServiceView.setChecked (Config. ProvideSmsService.equals ("true")? 
true:false); 
y saveSmsInfoView.setChecked (Config.SaveSmsInfo.equals ("true") ? true: false) ; 
12 keyWorkView.setText (Config.KeyWord) ; 
3 } 
4 
5 private void SaveConfig() { 
6 Config.CityName- cityNameView.getText () toString .trim(); 
H Config.RefreshSpeed- refreshSpeedView.getText () .toString ()7 
8 if (smsServiceView.isChecked()) ( 
9 Config.ProvideSmsService- "true"; 
20 elset 
21 Config.ProvideSmsService- "false"; 
22 
23 if (saveSnsInfoView.isChecked ()) { 
24 Config.SaveSmsInfo- "true"; 
25 
26 elset 
21 Config.SaveSmsInfo= "false"; 
28 
29 Config.KeyWord- keyiorkView.getText () .toString() .trim(); 
30 dbaqdapter.SaveConfig (); 
3 ] 


最 后 ,为 了 使 定义 的 Activity 和 ListActivity 生效 ,在 AndroidManifest. xml 文件 中 
注册 所 有 定义 的 组 件 。 
< activity android:name- ".WeatherDemo" 

android:label- "@ string/app name" 


1 
2 
3 < intent- filter> 
4 


X action android:name- "android. intent acte HIN" /> 
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< category android:name= "android.intent.category.LAUNCHER" /> 
< /intent- filter» 
< /activity> 
<activity android:name- ".WeatherActivity"/» 
€ activity android:name- ".HistoryActivity"/» 
10 «activity android:name=".SetupActivity"/> 
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附录 A 


Android 虚拟 设备 


Android 虚拟 设备 (AVD) 能 够 通过 Android 命令 行 工 具 进 行 管理 ,包括 AVD 的 创 
给 出 了 AVD 的 管理 命令 及 其 参数 说 明 。 


建 \ 删 除 、 移 动 和 更 新 等 。 表 A. 1 


RAL AVD 管理 命令 
命 令 参 数 说 明 备 注 
droid 显示 所 有 已 知 的 
i AVD, 内 容 包括 AVD 
I 的 名 称 .路 径 和 外 观 等 
-n <name> AVD 名 称 建立 AVD 的 必 备 参数 
使 用 android list targets 命令 获取 
-t <targetID> Android 系统 映像 ID Android 系统 映像 的 ID 列表 
-c <path> sk SD 卡 映像 文件 路 径 或 | 示例 1: -c path/to/sdcard 
-c <size>[K|M] SD 卡 映 像 的 容量 示例 2: -c 1000M 
如 果 新 建立 AVD 与 已 有 AVD 的 名 
称 相 同 , 则 Android 工具 将 提示 
android pu “AVD 已 经 存在 ", 自 动 停止 AVD 的 
create avd | f MAESE ANS 创建 过 程 。 使 用 该 参数 , Android T. 
具 将 自动 删除 已 有 同名 AVD, 并 建 
立新 的 AVD 
保存 AVD 文 件 和 目录 
-p <path> mw 
-s <name> HK 指定 AVD 的 外 观 . 利 | _. Ss 
-s<width> 用 外 观 名 称 或 长 宽 进 Zéi "Ne 
-<height> 行 选择 Ls dnd 
E MEL AVD 名 称 删除 AVD 的 必 备 参数 
-n <name> AVD 名 称 移动 AVD 的 必 备 参数 
aces MER 移动 后 的 AVD (EE 
-r <new-name> 重 命名 AVD 的 新 名 称 
android 为 所 有 Android 系统 


update avds 


映像 计算 路 径 
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使 用 标准 的 Android 系统 映像 创建 AVD BY, Android 工具 允许 用 户 选择 虚拟 设备 
所 支持 的 硬件 列表 , 表 A. 2 列举 出 可 以 选择 的 硬件 及 其 默认 值 。 同 时 ,用 户 也 可 以 在 
AVD 的 config. ini 文件 中 找到 相关 的 硬件 选择 设置 。 


表 A.2 虚拟 设备 硬件 令 列表 


特 征 描 述 属 性 

RAM 容量 物理 RAM 容量 ,单位 为 兆 ,默认 值 为 96 hw. ramSize 
触摸 屏 设备 是 否 支 持 触 摸 屏 ,默认 支持 hw. touchScreen 
轨迹 球 设备 是 否 支持 轨迹 球 ,默认 支持 hw. trackBall 
QWERTY 键盘 设备 是 否 支 持 QWERTY 键盘 ,默认 支持 hw. keyboard 
DPad 键 设备 是 否 支持 DPad 键 ,默认 支持 hw. dPad 
GSM 调制 解 调 器 | 设备 是 否 支 持 GSM 调制 解 调 器 ,默认 支持 “| hw. gsmModem 
摄像 头 设备 是 否 支持 摄像 头 ,默认 不 支持 hw. camera 
p : ig rig " 默认 值 为 640 hw. camera. maxHorizontalPixels 
ër EE 向 | 默认 值 为 480 hw. camera, maxVerticalPixels 
GPS 设备 是 否 支持 GPS, 默 认 支 持 hw. gps 
电池 设备 是 否 支持 电池 ,默认 支持 hw. battery 
加 速度 计 设备 是 否 支 加 速度 计 设 备 ,默认 支持 hw. accelerometer 
录音 设备 是 否 支 录音 ,默认 支持 hw. audioInput 

音 回放 设备 是 否 支持 声音 回放 ,默认 支持 hw. audioOutput 
SD 卡 设备 是 否 支持 虚拟 的 SD 卡 ,默认 支持 hw. sdCard 
缓存 分 区 是 否 在 设备 中 使 用 缓存 分 区 ,默认 使 用 disk. cachePartition 
缓存 分 区 容量 缺 省 值 为 66MB disk. cachePartition. size 


MFK B 


Android API 简介 


包 名 称 说 明 
android 包含 了 标准 Android 应 用 使 用 的 资源 类 
android. app 封装 了 全 部 Android 应 用 模型 的 高 级 类 
Android 允许 应 用 程序 发 布 嵌入 到 其 他 应 用 程序 中 的 视图 。 这 些 视 
android, appwidget 图 被 称 为 窗口 部 件 , 由 AppWidget providers 发 布 。 可 以 包含 窗口 
部 件 的 部 件 被 称 为 AppWidget host 
android, content 包含 了 用 来 在 设备 上 访问 和 发 布 数据 的 类 
det A e 包含 了 用 来 访问 应 用 程序 软件 包 信息 的 类 ,其 中 包括 它 的 行为 、 权 
mE 限 、 服 务 、 签 名 和 供应 商 等 信息 
包含 了 用 来 访问 应 用 程序 资源 的 类 ,比如 原始 的 有 价值 的 文件 ey 
android, content, res 色 YK .多 媒体 或 者 包 中 的 其 他 文件 ,还 有 影响 到 应 用 程序 如 何 
表现 的 重要 的 设备 配置 信息 (如 位 置 . 输 入 类 型 等 ) 
android. database 包含 用 来 探究 通过 内 容 提供 商 返 回 的 数据 的 类 
包含 了 SQLite 数据 库 管 理 类 ,应 用 程序 可 以 用 它 来 管理 自己 的 私 
android. database. sqlite 
有 数据 库 
id hi d Y MICI XU IS PEDE T. FL» EC Jn mi d V SEC A. IA 
osi 对 屏幕 绘图 进行 直接 控制 
android. graphics. drawable 提供 了 显示 的 多 种 视觉 元 素 的 类 ,比如 位 图 和 斜率 
android, graphics. 包含 了 用 来 绘制 几何 图 形 的 类 
drawable. shapes 
android. hardware 提供 对 可 能 并 不 是 每 台 Android 设备 都 具有 的 硬件 设备 的 支持 
android. inputmethodservice 写 入 方法 的 基础 类 
android. location 定义 了 Android 基于 位 置 服务 的 类 
android. media 提供 了 管理 语音 和 视频 中 的 多 种 媒体 接口 的 类 
android. net 协助 进行 网 络 存 取 的 类 ,包括 标准 java. net. * 应 用 程序 接口 
android. net. http 
android. net. wifi 提供 了 管理 设备 上 Wi-Fi 功能 的 类 
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包 名 称 说 HR 
android. opengl 提供 OpenGL 功能 
android. os 提供 设备 上 的 基本 操作 系统 服务 ,消息 路 由 和 进程 间 通 信 
android. preference 提供 管理 应 用 程序 性 能 和 执行 UI 参数 选择 的 类 
android. provider 提供 了 方便 的 类 用 来 访问 Android 的 内 容 提供 商 
android. sax 简化 SAX 操作 的 框架 
android. speech 
a eo 提供 了 应 用 程序 接口 用 来 监测 基本 电话 信息 ， 比如 网 络 类 型 和 连接 
状态 ,还 有 控制 电话 号 码 的 功能 
提供 了 应 用 程序 接口 用 来 使 用 GSM 特有 的 电话 性 能 ,比如 文本 / 数 
android. telephony. gsm R/PDU SMS 消息 
android. test 用 来 书写 Android 测试 框架 
android. test. mock 提供 了 存根 或 者 多 种 Android 框架 基础 模拟 的 功能 类 
android. test. suitebuilder 支持 试 运 行 类 的 功能 类 
android. text 提供 了 用 来 显示 或 追踪 屏幕 上 文本 和 文本 间距 的 类 
android, text. format 
android, text. method 提供 了 用 来 监测 或 修改 键盘 输入 的 类 
android, text. style 提供 了 用 来 显示 或 改变 文本 风格 的 类 
把 确定 的 文本 转化 为 可 点 击 的 链接 并 创建 RFC 822 消息 类 型 
android, text, util (SMTP) fri 
TE 提供 了 一 般 的 功能 方法 ,比如 日 期 /时 间 控 制 .64 位 编 解 码 器 .字符 
Rue 串 和 数字 转换 方法 和 XML 功能 
android. view 提供 用 来 显示 控制 屏幕 布局 和 用 户 交互 的 基本 用 户 接口 类 
android. view. animation 提供 用 来 控制 中 间 动 画 列表 的 类 
android. view. inputmethod 用 来 进行 视图 和 输入 方法 (比如 软 键盘 ) 交 互 的 框架 类 
android, webkit 提供 了 浏览 互联 网 的 工具 
android. widget 界面 组 件 ,包含 了 应 用 程序 屏幕 上 使 用 的 UI 元 素 


com, android. internal. os 


dalvik. bytecode 


提供 了 围绕 Dalvik 字 节 码 的 类 


dalvik. system 


提供 了 Dalvik VM 特有 的 功能 和 系统 信息 的 类 


java. awt. font 


java. beans 


java. io 


提供 了 流 输入 输出 方法 ,文件 系统 访问 和 串 行 化 


java. lang 


提供 了 Android 环境 的 核心 类 


续 表 

包 名 称 说 明 
java. lang. annotation 定义 了 注释 支持 必要 的 接口 和 例外 
java. lang. ref 
java. lang. reflect 
java. math 提供 了 高 精度 的 整数 和 小 数 
提供 了 网 络 相关 功能 ,比如 流 和 数据 包 套 接口 ,互联 网 地 址 操作 和 
java. net 处 理 HTTP 请 求 
java. nio 提供 了 协助 控制 数据 的 缓冲 区 


nio. channels 


提供 了 连接 数据 资源 比如 文件 、 套 接口 或 其 他 允许 输入 输出 数据 的 


ad 结构 的 方法 

java. nio. channels. spi nio channels 的 服务 提供 类 

java. nio. charset 提供 了 字 节 和 不 同 字符 集 之 间 的 转换 服务 
java. nio. charset, spi nio charset 的 服务 提供 类 

java, security 提供 了 所 有 组 成 Java 安全 框架 的 类 和 接口 
java, security, acl 提供 了 用 来 建立 访问 控制 列表 的 类 和 接口 


java. 


security. cert 


提供 了 用 来 生成 ,管理 和 证 实 X. 509 证 书 的 所 有 类 和 接口 


java. 


security. interfaces 


提供 安全 密 钥 的 接口 ,包括 : (1) 使 用 PKCS# 1 标准 的 RSA 非 均 匀 
加 密 算法 的 密 钥 ;(2) 以 FIPS-186 表示 的 数字 签名 算法 (DSA) 的 密 
钥 ;(3) 一 般 椭圆 曲线 不 均匀 算法 的 密 钥 


java. security. spec 为 加 密 和 签名 算法 的 特别 的 密 钥 和 参数 提供 了 类 和 接口 
java. sql 提供 了 标准 接口 用 来 访问 基于 SQL 的 数据 库 

java, text java. text 包 人 允许 打开 程序 中 来 自 自 然 语 言 的 文本 

java. util 提供 了 功能 类 的 扩展 

java. util. concurrent 功能 类 一 般 在 同时 运行 的 程序 中 比较 常用 


java. 


util. concurrent, atomic 


支持 在 单个 变量 上 解除 锁定 的 线程 安全 编程 工具 包 


接口 和 类 提供 了 一 个 框架 用 来 锁 住 并 等 待 来 自 于 内 置 同步 和 检测 


java. util. concurrent. locks 器 的 唯一 条 件 

java. util. jar java. jar 包 提供 了 读 取 和 写 和 人 Java 文档 文件 或 JAR 文件 的 权限 
java. util. logging 允许 为 任何 应 用 程序 添加 记录 

St, uec 提供 了 参数 选择 机 制 ,这 是 一 种 把 配置 数据 ( 键 值 对 ) 写 到 持续 的 数 
eee 据 存储 中 并 进行 检索 的 方法 

‘ 提供 了 正则 表达 式 的 一 种 执行 ,这 对 基于 形式 的 字符 串 匹 配 、 查 找 
Java. util. regex 


以 及 替换 来 说 是 有 用 的 


java, 


util. zip 


包含 了 压缩 和 解压 缩 ZIP 和 GZIP 格式 文件 的 类 
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包 名 称 


续 表 
说 明 


javax. crypto 


为 加 密 算法 应 用 程序 提供 类 和 接口 用 来 执行 加 密 、 解 密 和 关键 协议 
等 算法 


javax. crypto. interfaces 


这 个 包 提 供 了 用 来 执行 Diffie-Hellman (DH) 关 键 协议 算法 像 
PKCS# 3 的 接口 


javax. crypto. spec 


提供 了 加 密 需要 的 指定 密 钥 和 参数 的 类 和 接口 


javax. microedition. 


khronos. egl 


javax. microedition. 


khronos. opengles 


javax. net 


提供 了 工厂 类 用 来 创建 套 接 字 和 服务 套 接 字 


javax. net. ssl 


提供 了 用 来 执行 和 编写 基于 SSL 协议 SSSLv3. 0 或 TLSv1. 2 的 安 
全 套 接 字 的 所 有 类 和 接口 


javax. security. auth 


提供 了 用 来 执行 和 编写 用 户 授权 的 不 同方 法 和 基于 用 户 授 权 的 角 
色 的 类 和 接口 


javax. security. auth. callback 


提供 了 用 来 与 应 用 程序 进行 交互 以 执行 用 户 授 权 和 认可 的 进程 的 
类 和 接口 


javax. security. auth. login 


这 个 包 提 供 了 一 个 基于 UNIX-PAM 模型 的 概念 的 便携 可 折合 的 认 
证 系统 


javax. security. auth. x500 


提供 了 用 来 存储 X. 500 代理 以 及 其 认证 的 类 


javax. security. cert 


只 是 由 于 兼容 性 才 被 使 用 


javax. sql 提供 了 用 来 访问 基于 SQL 的 数据 库 的 标准 接口 
javax. xml 提供 了 一 个 带 有 有 用 的 XML 常量 的 公共 类 


javax. xml, parsers 


提供 了 用 来 解析 XML 文档 的 条 件 并 且 建 立 文档 对 象 模型 树 


junit, framework junit 测试 框架 
junit, runner 支持 junit 测试 框架 的 公共 类 
org. apache. http HTTP 协议 的 核心 接口 和 类 


org. apache. http. auth 


对 于 服务 器 来 说 的 客户 端 HTTP 认证 的 API 


org. apache. http. auth. params 


用 来 配置 HttpAuth 的 参数 


org. apache. http. client 


用 来 进行 客户 端 HTTP 通信 的 API 和 HttpClient 模型 的 入 口 点 


org. apache. http. client. entity 


org. apache. http. 


client. methods 


请 求 执行 各 种 HTTP 方法 ,比如 GET 和 POST 


org. apache. http. 


client. params 


用 来 配置 HttpClient 的 参数 


org. apache. http. 
client. protocol 


附加 请 求 及 回应 拦截 


BER 
包 名 称 说 明 
org. apache. http. client. utils HttpClient 的 助手 和 公共 类 
org. apache. http. conn 客户 端 连接 管理 和 控制 HttpConn 中 心 的 API 
org. apache. http. conn. params | 用 来 配置 HttpConn 的 参数 
org. apache. http. conn. routing | 客户 端 路 由 代理 和 跟踪 API, HttpConn 的 一 部 分 
org. apache. http. conn. scheme 
org. apache. http. conn. ssl TLS/SSL HttpConn API 特有 的 部 分 
org. apache. http. conn. util 
org. apache. http. cookie 通过 cookies 进行 客户 端 状态 管理 的 API 
ies rati 用 来 配置 HttpCookie 的 参数 
org. apache. http. entity HTTP 消息 实体 的 代理 
org. apache. http. impl org. apache. http 中 接口 的 默认 执行 
org. apache. http. impl. auth 
org. apache. http. impl. client 
org. apache. http. impl. conn 
org. apache. http. impl. 


conn, tsccm 


一 个 线程 安全 的 客户 端 连接 管理 的 一 次 执行 


org. apache. http. impl. cookie 

org. apache. http. impl. entity org. apache. http. entity 中 接口 的 默认 执行 

org. apache. http. impl. io org. apache. http. io 中 接口 的 默认 执行 

org. apache. http. io HTTP 部 分 的 传输 层 

org. apache. http. message HTTP 消息 执行 的 选择 

org. apache. http. params HTTP 部 分 的 参数 框架 

org. apache. http. protocol HTTP 协议 执行 框架 

org. apache. http. util 出 于 各 种 目的 的 带 有 静态 辅助 方法 的 公共 类 

org. json 

org. w3c. dom 提供 了 正式 的 W3C 的 Java 绑 定 的 文档 对 象 模型 ,2 级 核心 
org. xml. sax 提供 了 核心 SAX APIs 

org. xml. sax. ext SAX2 条 件 的 接口 ,保证 了 SAX 驱动 并 不 一 定 要 支持 
org. xml, sax. helpers 辅助 方法 类 

org. xmlpull. v1 


org. 


xmlpull. vl. sax2 


附录 C 


类 E Lj Ki 说 RB 
指定 adb 命令 发 往 连接 的 USB 设备 (备注 : 如 果 
—d 连接 两 个 或 两 个 以 上 的 USB 设备 , 则 返回 错误 
提示 ) 
指定 adb 命令 仅 发 往 运行 的 Android 模拟 器 ( 备 
参数 =e ik: 如 果 有 两 个 或 两 个 以 上 的 Android 模拟 器 在 
运行 , 则 返回 错误 提示 ) 
指定 adb 命名 链接 的 模拟 器 或 设备 ,模拟 器 或 设 
—s <serialNumber> 备 通 过 “emulator- 端 口 ” 的 方式 指定 ,例如 
emulator-5556 
devices 显示 所 有 链接 的 模拟 器 或 设备 列表 
通用 命令 help 显示 adb 支持 的 命令 列表 
version 显示 adb 的 版 本 号 
logcat[ 一 option 二 ] = 
[<filter-specs> ] 显示 日 志 数据 
调试 命令 bugreport 显示 dumpsys,dumpstate 和 logcat 数据 
jdwp 显示 指定 设备 的 JDWP 进程 列表 
install <path-to-apk> 将 Android 应 用 程序 安装 到 模拟 器 或 设备 
数据 命令 pull <remote> <local> 将 模拟 器 或 设备 上 的 指定 文件 复制 到 开发 主机 
push <local> <remote> 将 开发 主机 上 的 指定 文件 复制 到 模拟 器 或 设备 
将 本 地 端口 的 Socket 链接 的 数据 转发 到 特定 的 
n 与 端口 forward <local> <remote> keier Sg E 
ei ppp <tty> [parm] 在 USB 上 运行 PPP 
get-serialno 显示 adb 链接 的 模拟 器 或 设备 的 序列 号 
脚本 命令 get-state 显示 adb 链接 的 模拟 器 或 设备 的 状态 


wait-for-device 


阻止 程序 运行 ,等 待 设备 就 绪 


Dr 
类 a $ e mz 明 
ere start-server 启动 adb 服务 进程 
kill-server 终止 adb 服务 进程 
shell 针对 目标 模拟 器 或 设备 启动 一 个 Shell 
Shell 命令 针对 目标 模拟 器 或 设备 启动 一 个 Shell, 并 直接 执 


shell [<shellCommand> ] 


fT Shell 474 <shellCommand> 


附 x D IX | le EE 
Android Manifest 文件 


一 个 Android 应 用 程序 都 有 一 个 AndroidManifest. xml 文件 ,用 以 在 程序 运行 前 
向 ree 系统 声明 程序 的 相关 信息 ,这 些 信 息 包 括 应 用 程序 需要 的 许可 、 程 序 运 
最 低 SDK 版 本 ,程序 运行 所 需要 的 硬件 支持 和 函数 库 等 等 。 

AndroidManifest. xml 文件 主要 由 元 素 、 属 性 和 类 声明 等 重要 部 分 组 成 。 在 
AndroidManifest. xml 中 ,多 数 元 素 的 出 现 次 数 没 有 限制 ,而 且 在 同一 层次 的 元 素 没 有 顺序 
OF. [f] All — activity , — provider Hl service JER n] EAT fa] Jt er HE a. [H — manifest HI 
— application 之 元素 只 能 在 AndroidManifest. xml 中 出 现 一 次 ,而 且 必 须 出 现 一 次 。 


AndroidManifest. xml 文件 的 元 素 与 属性 关系 参考 表 D. 1, 通 用 结构 如 下 所 示 : 


行 前 
行 的 


1 < ?xml versia "1.0" encoding- "utf- 8"?> 
2 

3 <manifest> 

4 <uses- permission /> 

5 « permission /> 

6 <pemmission- tree /> 

7 <penmission- group /> 

8 < instrumentation /> 

9 < uses- sdk /> 

10 «application» 

n «activity» 

12 « intent- filter» 

13 «action /> 

14 < category /> 

15 X data /> 

16 < /intent- filter» 

17 <meta- data /> 

18 < /activity> 

19 <activity- alias» 

20 < intent- filter>… < /intent- filter> 
KA <meta- data /> 

22 < /activity- alias» 

23 < service» 

24 < intent- filter» --- < /intent- filter» 
25 «meta- data/> 


26 < /servioe» 
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< receiver» 
X intent- filter» --- < /intent- filter» 
<meta- data /> 
< /receiver» 
X provider 
« grant- uri- permission /» 
«meta- data /> 
< /provider> 
« uses- library /> 
« uses- configuration /> 
< application» 
< /manifest^ 
在 通常 情况 下 ,元 素 的 属性 是 用 来 描述 如 何 解释 元 素 内 容 , 一 般 都 是 可 以 省 略 的 。 
但 在 AndroidManifest. xml 中 ,为 了 使 元 素 具 有 意义 ,一 些 特定 的 属性 是 不 能 够 省 略 的 ， 
ffi] 4l — manifest 776 SE BJ — xmlIns : android — Ji ER< package 二 属性 。 如 果 需 要 为 同一 
个 元 素 的 属性 指定 多 个 值 , 则 需要 重复 书写 这 个 元 素 ,书写 方法 如 下 所 示 。 


BSRRKBRRBBBYN 


1 < intent- filter …> 

2 < action android:name= "android. intent .action.EDIT" /> 

3 <action android:name- "android.intent.action.INSERT" /> 
4 < action android:name= "android.intent.action.DELETE" /> 
5 m 

6 


< /intent- filter» 


UB Soo X AE% & eR] UTE activity >, < service H< receiver > 4$ 76 
素 。 如 果 在 直接 通过 android: name 属性 声明 类 名 , 则 声明 的 类 名 必须 包含 完成 的 包 名 
称 。 但 如 果 在 二 manifest 志 元素 中 使 用 了 二 package 二 属性 , 则 可 以 在 android: name 属 
性 声明 类 名 时 不 包含 完整 的 包 名 称 。 区 别 可 以 参考 下 面 的 两 段 代码 。 

完整 类 名 : 
«manifest …> 


«application => 
< service android:name- "edu.hrbeu.MyService" …> 


< /service» 


1 
2 
3 
4 
5 
6 I 
7 < /application> 
8 < /manifest> 


简化 类 名 : 


«manifest package= "edu.hrbeu" …> 
<application … > 
< service android:name- ".MyService" =- > 


</service> 


< /agplication> 


1 
2 
3 
4 
5 
6 
7 
8 < /manifest^ 
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读者 意见 反馈 


亲爱 的 读者 : 
感谢 您 一 直 以 来 对 清华 版 计算 机 教材 的 支持 和 爱护 。 为 了 今后 为 您 提供 更 优秀 的 
教材 ， 请 您 抽出 宝贵 的 时 间 来 填写 下 面 的 意见 反馈 表 ， 以 便 我 们 更 好 地 对 本 教材 做 进 
一 步 改 进 。 同 时 如 果 您 在 使 用 本 教材 的 过 程 中 遇 到 了 什么 问题 , 或 者 有 什么 好 的 建议 ， 
也 请 您 来 信 告诉 我 们 。 
地 址 : 北京 市 海淀 区 双 清 路 学 研 大 厦 A E 602 室 计算 机 与 信息 分 社 营销 室 收 
邮编 : 100084 电子 邮件 : jsjjc@tup.tsinghua.edu.cn 
电话 : 010-62770175-4608/4409 邮购 电话 : 010-62786544 


教材 名 称 : Android 应 用 程序 开发 
ISBN: 978-7-302-21699-5 


年 龄 : 所 在 院 校 /专业 : 
通信 地 址 : 
i 电子 信箱 : 
eR BIE: 指定 教材 口 选用 教材 口 辅导 教材 
您 对 本 书 封面 设计 的 满意 度 : 
很 满意 口 满意 - 般 口 不 满意 ”改进 建议 
您 对 本 书 印刷 质量 的 满意 度 : 
很 满意 口 满意 口 一 ] 不 满意 ”改进 建议 


您 对 本 书 的 总 体 满意 度 : 

从 语言 质量 角度 看 口 很 满 满意 口 一 般 口 不 满意 
从 科技 含量 角度 看 DB 满意 口 一 般 口 不 满意 
本 书 最 令 您 满意 的 是 : 
指导 明确 口内 容 充 实 口 讲解 详尽 口 实例 丰富 
您 认为 本 书 在 哪些 地 方 应 进行 修改 ? (可 附 页 ) 


您 希望 本 书 在 哪些 方面 进行 改进 ? 〈 可 附 页 ) 


电子 教案 支持 


敬爱 的 教师 : 

为 了 配合 本 课程 的 教学 需要 ， 本 教材 配 有 配套 的 电子 教案 (素材 )， 有 需求 的 教师 可 
以 与 我 们 联系 ， 我 们 将 向 使 用 本 教材 进行 教学 的 教师 免费 赠送 电子 教案 (素材 )， 希 望 有 
助 于 教学 活动 的 开展 。 相 关 信 息 请 拨打 电话 010-62776969 或 发 送 电子 邮件 至 
jsjjc@tup.tsinghua.edu.cn 咨询 ， 也 可 以 到 清华 大 学 出 版 社 主页 Chttp://www.tup.com.cn 或 
http://www.tup.tsinghua.edu.cn) 上 查询 。 


